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SECTION 1 


1. INTRODUCTION 


This manual provides information on the B80 CMS MCP, 

with specific reference to the 3.01 release. It is intended 
for systems software support personnel, for use when analysing 
problems and as a guide to the analysis of memory dumps. 


The taking of memory dumps and the use of PMB80 to print out 
selected information is explained. The output of PMB8O is 
discussed in detail. 

Section 4 recommends a method of approach to a systems problem 
on the CMS B80. The subsequent sections explain the memory 
organisation, and the main features of the MCP which help 
towards a general understanding of the system. This is 
necessary in order to understand a memory dump. 


Section 10 presents details on disk organisation which apply to 
all CMS systems. 


The analysis of datacomm areas and the investigation of problems 
in the B80 Stand Alone Utility are not discussed. 


The codes used in the tables to specify the format of MCP maps 
are explained in Table 1.1.1. The bit numbering convention 
followed, is that the most significant bit of a byte is numbered 
7 and the least significant bit is numbered 0. 


The Appendix gives an index of terms used in the body of this manual 
manual, and explains the meaning of the commonly-used acronyms. 


This information should be used by all persons involved in the 


diagnosis of CMS B80 system problems and the support of the 
system software. 
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TABLE 1.4.4 - FORMAT CODES USED IN TABLES 
ABBREV. FORMAT CODE HEANING 


information stored in ASCII collating sequence 
information stored in EBCDIC collating sequence 
information stored in Binary Coded Decimal format 
information stored in binary 
BYTE REVERSED binary inforaation stored byte reversed 
most significant byte at highest memory address (on the right) 
ABSOLUTE ADDRESS field contains an absolute memory address 
RELATIVE ADDRESS a memory address relative to some base 
SELF RELATIVE a aemory address relative to the field 
INDEX a byte index into a field or map 
SUBSCRIPT a subscript in a table 


LABEL the field name does not reference a field of data 
but is used to label a meaory address 
NOTE NOTE n refer to the note at the base of the table 


TABLE TABLE nanan refer to the appropriate table in this newsletter 
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FORMAT CODES USED IN TABLES 


CONTENTS - FIGURES 


6.1.1 
6.2.1 
6.3.1 
6.4.1 
6.5.1 


AREAS OF MEMORY 
RESIDENT AREA LAYOUT 
LOCKED AREA LAYOUT 
OVERLAYABLE AREA LAYOUT 
PHT AREA LAYOUT 
EXTENDED MEMORY LAYOUT 


USER TASK COMPONENTS IN MEMORY 
COBOL/RPG TCB COMPONENTS 
COBOL/RPG PCB COMPONENTS 

MPLII (BIL) TCB COMPONENTS 


LOGICAL AND PHYSICAL I-O STRUCTURE 
CMS DISK ORGANISATION 

KEY FILE ORGANISATION 

PROGRAM FILE ORGANISATION 

PROGRAM DUMP FILE STRUCTURE 


CONTENTS - TABLES 
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CODES USED IN TABLES 

MEMORY DUMP TO CASSETTE-ERROR CONDITIONS 
MEMORY DUMP TO DISK - ERROR CONDITIONS 
SYSTEM REGISTER USERS 

TRACE DIAGNOSTIC CLASSES 


(eo) 
| 


FILE OPEN AND CLOSE 
- INDEXED FILE I-0 

- ACCEPT, DISPLAY, DATE AND TIME 

- INTRINSIC UTILITIES 

- AUTOMATIC VOLUME RECOGNITION (AVR) 

- DISK SPACE ALLOCATION OR DE-ALLOCATION 
INTERPRETERS 

- COMMUNICATE HANDLING (MCH) 

- VIRTUAL MEMORY (VM) 

- TASK CONTROL (EPAR) 

- INPUT-OUTPUT QUEUE HANDLING 
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MEMORY CONTENTS DESTROYED BY BOOTSTRAP 
SATM MAP (SLICE ADDRESS TABLE) 


RS MAP (SLICE DESCRIPTOR) 
SLICE DESCRIPTOR FLAGS 


SD MAP (SEGMENT DESCRIPTOR) 
SEGMENT DESCRIPTOR FLAGS 


INTERGLBL MAP 


PHDMP MAP 
DEVICE MNEMONICS IN DESCENDING ORDER OF PRIORITY 


VERSION. INFO MAP 


DIAGCBUF MAP 
TOP OF CONTROL STACK - RETURN ADDRESS 


VMWA MAP 


CONTENTS - TABLES (CONT.) 


GLBLM MAP 

TASK-ID, TASK STATUS, MIX NUMBERS 
WAIT KEY VALUES 

BALIFF FLAGS: VOL,EREADY,EVICT,BrLAG 


SCL BUFFER 


TASK TYPES 


TASKTAB MAP 
TASK MAP 


ds 

2 

3 

4 

1 

ok CT. INFO 
1 

1 

2 

1 COBOL.TCB MAP 

2 MTCB MAP 

8.4.) COMMUNICATE VERBS 
FETCH VALUES 


FPB MAP 

DEVICE KINDS 

FPB FLAGS 
ADVERB FOR OPEN 
ADVERB FOF CLOSE 


4.2 

5.1 

5.2 

5.3 

5.4 

5.5 

6.1  MFIB MAP 
6.2  VEST.FIB MAP 
6.3. FILESTATE 
.6.4 FILETECHNIQUE 
7.1  IFIB MAP 

7.2 IKEYFLAG 
7.3. IFIBMOREFLAG 
Le 
Le? 
2.1 
pe 
253 
2.4 
2.5 


CT MAP 
CONFIGURATION 


PHTH MAP 

CHANNEL ADDRESSES 
DSKPM MAP 

DISK STATUS 
CASSETTE STATUS 
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SELF SCAN STATUS 
PRINTER STATUS 
KEYBOARD STATUS 


9.2.6 

9.2.7 

9.2.8 

9.2.9 S-FLAGS 

9.3.1  QHEAD MAP 

9.3.2 QUEUE FLAGS 

9.3.3 IODESC MAP 

9.3.4 I-O DESCRIPTOR FLAGS 

10.2.1 DISK LABEL 

10.2.2 BAD AREA LOG 

10.3.1 AVAILABLE TABLE BLOCK 

10.3.2 NAME LIST BLOCK 

10.3.3 DISK FILE HEADER (DFH) 

10.3.4 DFH FILETYPES 

10.4.1 KEY FILE PARAMETER BLOCK (KFPB) 
10.4.2 ROUGH TABLE ENTRY 

10.4.3 KEY ENTRY (INDEX OR OVERFLOW) 


PROGRAM PARAMETER BLOCK (PPB) 
PROGRAM SEGMENT DESCRIPTOR 
PROGRAM INTERNAL FILE NAME BLOCK ENTRY 
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SECTION 2 


2. TAKING MEMORY DUMPS 


It is very important that a memory dump is taken each time 
an unexplained failure of the MCP occurs. It is equally 
important that the dump is taken properly and contains 
useful information. This section clarifies the memory 
dump procedures. 


Memory dumps may be taken on either cassette or disk. 
After the system has initialised (either automatically, 

or by using the initialise button inside the cabinet), 

the system is in the initial state with PKl and PK2 lit. 
If PK2 is pressed, the ROM bootstrap loads the disk 
bootstrap to memory. PKs 3, 4, 5 & 6 are then enabled. 

If PK4 is pressed, then the contents of memory may be 
dumped to cassette; PK5 will cause the contents of memory 
to be dumped to disk. 


The contents of a memory dump are only useful if the MCP 
had previously been running. Dumps taken after the Stand 
Alone Utilities have been running are of no use. Also, if 
PKl is pressed when PKl & PK2 are enabled in the initial 
state, then memory is cleared and memory dump taken after 
this is of no use. 


If an error condition arises during the memory dump routine 
then a pattern of PK-lights will be lit indicating the 

error (see tables 2.1.1 and 2.2.1). The error should be 
corrected, the system initialised again, and the memory 

dump re-attempted. The memory dump routine destroys the 
contents of only a very few memory locations (see Table 6.1.1) 
and repeated attempts at dumping the contents of memory may 
be made without destroying further information. 


Qa: MEMORY DUMP TO CASSETTE 


If PK4 is pressed while the system is in the bootstrap- 
loaded state, then the bootstrap routine attempts to 
dump the contents of memory to cassette. “ne numeric 
keyboard is enabled and a drive number (1-4) must be 
keyed. The number 1 indicates the drive referenced by 
the mnemonic CTA by the MCP, and so on. 


2015400 


Pi 
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TAKTNG MEMORY DUMPS (CONT. ) 


MEMORY DUMP TO CASSETTE (CONT.) 


If the memory dump routine encouters an error condition, 
then an indication of the fault is given on the key-board 
lights (see Table 2.1.1). The error should be corrected, 
the system initialised again, and a second attempt should 
be made to dump the contents of memory. 


A memory dump cassette has the format of a single file CMS 
tape with a label of MEMDUMP/MEMORY and a record and block 
size of 256 bytes. 


MEMORY DUMP TO DISK 


If PK5 is pressed while the system is in the bootstrap- 

loaded state, then the bootstrap routine attempts to dump 

the contents of memory to disk. The memory dump routine 

does not create a file on disk, but uses a file already 
present. A search is made on disk for a file called 

MEMDUMP and then the contents of memory are written to this 
file until either the end of memory is reached or the disk file 
is full. 


The MEMDUMP file is created on disk by the utility GEN.DUMPFL. 
It has a record and block size of 180 bytes, and a defauit 
filesize large enough to hold 65KB of memory. A larger 
MEMDUMP file may be created by using an initiating message 
with GEN.DUMPFL. For example: "GEN.DUMPFL 128" will create 
a MEMDUMP file large enough to hold 128 KB of memory. 


If the memory dump routine encounters an error condition, then 
an indication of the fault is given on the key-board lights 

(see Table 2.2.1). The error should be corrected, the system 
initialised again, and a second attempt should be made to dump 


tonte «= 


si Lf warmer 
the contents of memory. 


If there is more than one disk on the system which 
holds a MEMDUMP file, then confusion may arise about 
which file contains the latest dump. To avoid this 
confusion, it is recommended that a disk is set aside 
which contains a MEMDUMP file of the required size. 


Before a memory dump is taken, all other disks should 
be removed and this disk should be loaded. 


Before this disk is re-used, the dump should be analysed 
or the MEMDUMP file copied to another disk for subsequent 
analysis. 
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SECTION 2 - TAKING MEMGRY DUMPS 


TABLE 2.1.1 - MEMORY DUMP TO CASSETTE - ERROR CONDITIONS 


The following conditions cause the error tight to be lit when a 
menory duap is being taken on cassette t- 


The cassette drive aumber keyed does not exist 
The cassetie drive does not hold a cassette 
The cassette is not writs enabled 


To recover the situation, correct the error, hit raset and ratry. 


TABLE 2.2,1 - MEMORY DUMP TO DISK - ERROR CONDITIONS 


ERROR D-tights PK-Lights 


ee ee a ee ee ene 


device error channel address PRé=0ff 
no MEMDUNP file on disk 1-B atl tis PRé=o0ff 
PEMDUMP file too smal! channal addrass e-B atl on 
pressed FKS nok PK4 all aff all off 


Channel address on D-lights :- Dischannel 0, B@=chanaet i ate. 
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MEMORY DUMP TO CASSETTE - ERROR CONDITIONS .and 
rr 
MEMORY DUMP TO DISK ~- ERROR CONDITIONS 
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SECTION 3 


3% PRINTING MEMORY DUMPS 
It is possible to list a memory dump file in hexadecimal 
and perform the analysis by hand. This however, is a laborious 
approach, and is not usually required. ‘The CMS B80 system 
includes a memory dump analyser called PMB80. 
PMBSO is a sophisticated Lovl for selecting and printing infor- 
mation from a system dump file. It also performs some dump 
analysing functions by highlighting suspected errors, but it is 
best to confirm these errors by checking the data. 
This section presents the features of PMB8O used in memory dump 
analysis. 
Bad: PMB80 AND ITS WORKFILES 
The system dump analyse utility consists of the program 
PMB80 and four reference files PMBHELP, PMBERROR, PMBM.nnnnn 
and PMBO.nnnnn. 
Each major release of the B80 system contains all of these 
files. In addition, if the format or location of MCP tables 
(known as MCP "maps") changes with a new version of the MCP, 
then the Map and Offset files PMBM.nnnnn and PMBO.nnnnn are 
re-released with the MCP with a new value of nnnnn to identify 
the MCP version. 
The PMBHELP file contains the syntax of the PMB80 commands, 
and is used to provide the HELP function. 
The PMBERROR file contains the messages output by the dump 
analyser. It may be listed by the LIST utility to provide 
a list of all possible messages. 
The PMBM.nnnnn file holds the format and names of the field 
of the MCP Maps. The PMBO.nnnnn file holds the memory Offsets 
of these maps. 
2015400 


3. PRINTING MEMORY DUMPS (CONT.) 
31 PMB8O AND ITS WORKFILES (CONT.) 


The nnnnn represents the mark, level and patch numbers 

of the corresponding MCP code file. For example with 

the 3.01 MCP, the value of nnnnn is 30100. PMB80O can 
analyse memory dumps of different levels of the MCP. It 
selects the appropriate Map and Offset files with reference 
to the field VERSION of map INTERGLBL (Table 7.1.1). 


If an attempt to execute PMB80 results in "NO FILE" messages 
for the Map and Offset files with unrecognisable names, the 
the VERSION field is likely to be corrupt. This could be 

a first indication that the memory dump does not contain 
useful information. 


3.2 STARTING PMB80 - THE INITIATING MESSAGE 


The utility can be executed with a number of options, 
selected by the initiating message as follows: 


PMB80 


The options provide the following features: 


GET - This option is used to specify the file-id of a disk 
memory dump other than "MEMDUMP" (the default value). 


ON - This option is used to specify the disk-id of the disk 
containing the memory dump file, if other than the 
system disk. 


AX - This option instructs PMB80 to communicate with 
the operator via DISPLAYS and ACCEPTS. If this 
option is not specified, then a CONSOLE file is 
used. 


If a disk file called MEMDUMP and a cassette file labelled 


MEMDUMP/MEMORY are both present, then PMB80 takes the disk 
file as input. 
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PMB80 OPTIONS AVAILABLE 


The utility does not print or analyse automatically. The 
functions of PMB80 are provided on command from the operator. 
The options available are as follows: 


Sods 


3.3. 


A. 


2 


< PMB80 option > 


PRINT 


< print antion > 


DISPLAY = 
CHECK < check option > 
PATCH < patch option > 
SAVE 


< save option > 


END 
BYE 


THE HELP OPTION 


The HELP option of PMB80 lists the PMB80 options 
available. If a particular PMB8O option is included 
(e.g. HELP PRINT) then the syntax and explanation of 
the various functions of that option are given. 
Functions can be described in further detail by 
specifying other options, (e.g. HELP SLICE will give 
details of the PRINT SLICE function). 


THE PRINT AND DISPLAY OPTIONS 


These options control the printing and analysis of 
selected information. 


The PRINT option is the most useful option of PMB80 
and is explained in greater detail in section 3.4. 


The DISPLAY option provides the same features as the 
PRINT option, but uses the SPO instead of a PRINTER. 
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Jus PMB80 OPTIONS AVAILABLE (CONT.) 
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3.3.4 


PATCH 


THE CHECK OPTION 


This option has the following syntax: 


CHECK MEMORY.LINKS 


ALL.MEMORY 


This command instructs PMB80 to analyse the contents 
of the memory dump and report on any errors encountered. 


The MEMORY.LINKS option causes PMB80 to check the 
structure of overlayable memory (see section 6.4.1). 
The ALL.MEMORY option instructs PMB80 to check the 
complete memory structure, and some fields are also 
checked for valid contents. 

It should be noted, however, that it is not feasible 
for PMB80 to perform a complete analysis of all 
possible faults. Therefore this option may report an 
error where no real error exists. Consequently, all 
faults reported by PMB80 should be verified by checking 
the data concerned. 


THE PATCH OPTION 


This option has the following syntax: 


< hex address > < hex value > 


NEXT 


3. PRINTING MEMORY DUMPS (CONT.) 
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PMB80 OPTIONS AVAILABLE (CONT.) 


3.3.4 


SAVE 


THE PATCH OPTION (CONT.) 


ONE - specifies that the patch is to be 
performed on page one (extended memory). 


NEXT - specifies that this patch is to follow 
directly after the previous patch. 


<hex-address> 


is four hexadecimal digits with no 
delimiters. 


<hex-value> is from one to 16 hexadecimal digits. 


Sometimes a memory dump contains corrupt information 


which limits the extent of useful analysis that can be 
performed by PMB8O. 


The PATCH option enables the operator to correct invalid 
areas of memory, enabling PMB80 to continue its analysis. 
The patches are applied to an internal PMB80 work file, 
leaving the original dump file unchanged. 


The modified dump file may be saved using the SAVE option 
{see section 3.3.5). If this action has been taken, 

details should be documented when reporting a problem, and 
both the original and patched dump files should be submitted. 


THE SAVE OPTION 


The syntax for this option is: 


AS — <file-id> ON — <disk-name> 


AS - This option allows the operator to specify 
the file-id of the memory dump file which is 
saved. The default value is "MEMDUMP", 


ON - This option allows the operator to specify 
the disk-id of the disk on which the dump file 
is to be saved. If this option is not used, then 
the dump file will be saved on the system disk. 


THE END AND BYE OPTIONS 


Either of these options will cause PMB80 to go to 
end of job (EOJ). 
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3. PRINTING MEMORY DUMPS (CONT.) 


3.4 THE PRINT OPTIONS 


The options availabie within the print command are as follows: 


PRINT MIX 
MEMORY.MAP 
MEMORY.LINKS 


< map name > 


GLOBAL 

OL 

PHT ————_——._ < pht option> 
SLICE —————-_ <slice option > 
TASK ——-————-__ < task option> 
ALL.MEMORY 

HEX = _Co <hrex option > 


above. 


‘The MIX option provides information on the tasks that were 
running. If a hardware problems is suspected, then the OL 
and PHT options provide information on the s 2 
configuration. The following sections explain the PRINT 
options in more detail. 


3.4.1 THE PRINT MIX OPTION 


This option provides a selective analysis of information 
contained in the global MCP map GLBLM (Table 7.6.1) 
and the TASK.TABLE (Tables 8.2.1 and 8.2.2). 


A list is given of the tasks running at the time of the 
dump, what status these tasks were in, and which tasks 

(if any) held locks to non re-entrant MCP code. Since 

the TASK.TABLE is an overlayable segment of the Bailiff 
Slice (Slice 0) the task names may not be available on 

the memory dump. 


3. PRINTING MEMORY DUMPS (CONT.) 


3.4 
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THE PRINT OPTIONS (CONT.) 


3.4.2 


3.4.3 


3.4.4 


THE PRINT MEMORY.MAP OPTION 
Se ee ee VEL LUN 


This option provides an analysis of the layout of memory. 
The contents of the five sections (RESIDENT, LOCKED, 
OVERLAYABLE, PHT, EXTENDED) are listed in the order in 


which they occur. If any faults such as overlapping fields 


are detected, then a message is printed. 


It is always advisable to check such error messages 
carefully. Sometimes the overlap is not a real error 
(for example: Zero length segments may legally overlap; 


within its CONTROL STACK: the INTTTALISE (elvoo TO) sipce 
descriptor may overlap since it is not used; 
etc.). 


The analysis of the locked and overlayable areas 

is performed through the SAT, slice descriptors and 
Data Segment Tables (see Section 6.3). Any error 
reported in this part of the analysis implies an 
error in one of these structures. 


THE PRINT MEMORY.LINKS OPTION 
ae eee ME 


This option analyses the layout of the OVERLAYABLE 
AREA of memory. The analysis is performed through 
the memory link mechanism described in Section 6.4. 
Any error reported with this option indicates the 
corruption of this structure. 


If the system was performing virtual memory operation 
when the dump was taken, then the memory links are 
likely to be in a transient state and no conclusion can 
be drawn from apparent errors. In this condition, the 
PRINT MIX option will show the VMLOCK to be held by a 
task. 


THE PRINT GLOBAL OR PRINT < map name> OPTION 


This option causes MCP tables to be printed in a map 
format. A map is a "template" which the MCP uses to 
define its data structures. The <map name>s available 
are: 


GWA : Global Work Area. See Table 7.1.1 - 
INTERGLBL MAP, and Section 7.1. 
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THE PRINT OPTIONS (CONT.) 


3.4.4 THE PRINT GLOBAL OR PRINT map name OPTION (CONT.) 

PHDMP : Peripheral Handling dump area. See 
Table 7.2.1 and Section 7.2. 

DIAGNOSTICS : See Table 7.4.1 - DIAGCBUF MAP and 
Section 7.4. 

VMWA : Virtual Memory Work Area. See Table 
7.5.1 and Section 7.5. 

ESCT : Execution Scan Table. See Table 7.6.1 - 
GLBLM MAP, and Section 7.6. 

SCL : Slice Address Table. See Table 6.2.1 
SATM Map and Section 6.2. 

TASK. TABLE : See Tables 8.1.1 and 8.1.2 and Section 8.1. 
This table is overlayable and therefore 
may not be present in memory. 

C.TABLE : Configuration Table. See Table Ql 
CT MAP, and Section 9.1. This table is 
overlayable and therefore may not be present 
in memory. 

The PRINT GLOBAL option will cause the global MCP tables 

(INTERGLBL, PHDMP, VERSIONINFO, DIAGCBUF, VMWA, GLBLM, 

SCL, CT.INFO, SAT) to be printed. 

3.4.5 THE PRINT OL OPTION 

This option provides a selective analysis of information 

contained in the C.TABLE (Table 9.1.1). This includes the 

peripherals configured on the system, any media loaded on 
the peripherals, and the status of the peripherals. The 

C.TABLE is overlayable and so this analysis may not be possible. 

3.4.6 THE PRINT PHT OPTION 

This option enables the printing of the Peripheral 

Handling Table for selected device types present 

on the system. The syntax is: 

PRINT PHT 


< device mnemonic> 
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THE PRINT OPTIONS (CONT.) 


3.4.6 


3.4.7 


PRINT SLICE 


THE PRINT PHT OPTION (CONT.) 


Valid <device mnemonicys include: 


DF - Fixed Disk 

DK - Disk Cartridge 

DM - Burroughs Super Mini Disk 
LP - Line Printer 

SP - Serial Printer 

ss - Self Scan 

KB - Keyboard 

cT - Cassette 

CX - Channel Expander 

DI - Industry Compatible Mini disk 
ADC - Async. Data Comm 

SDC - Syne. Data Comm 


For each <device mnemonic) specified, all the PHTs 
for devices of that type are printed. If no <device 
mnemonic} is entered, then all the PHTs in the dump 
are printed. 


In addition to printing the PHTs, this option prints 
the I-O queues, queued descriptors, and keyboard, console 


and SPO buffers (where applicable). Sections 9.2 and 
9.3 discuss these tables in more detail. 


THE PRINT SLICE OPTION 


This command prints the contents of selected slices 
(see section 6.3 for a description of memory slices). 


The syntax is: 


<slice option> DATA.SEGMENTS 


DATA.SEGMENTS - This option prints the contents of 
the data segments in the overlayable 
area. If this option is not used, then 
only the contents of the locked slice will 
be printed. 
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THE PRINT SLICE OPTION 


(CONT. ) 


Values for <slice option) include: 


0-48 


SUSN 


OPENCLOSE 


: 


INITIALISE 


SPO 


LPDDR 


CASSDDR 


DISKDDR 


SENDDR 


KBDDR 


SCREENSN 


ADCDDR 


SDCDDR 


DCCH 


CONSOLE 


PANDDR 


INXS 


ICMDDDR 


CONBUF'SN 


SCLBUFSN 


oe 


Any number in this range refers to a slice 
See Table 6.2.1 - SATM MAP 


(Slice 12) 


(Slice 17) 
(Slice 
(Slice 
(Slice 
(Slice 
(Slice 
(Slice 23) 
(Slice 
(Slice 
(Slice 26) 
(Slice 


(Slice 28) 
MCP code. 


(Slice 29) 
MCP code 


(Slice 20) 


Super Utility TCB (data) 
File Open & Close MCP code 
Warmstart MCP code 

SPO printing MCP code 

Line printer DDR code 
Cassette DDR code 

Disk DDR code 

60 cps Serial Printer DDR code 
Keyboard DDR code 
Self-Scan/CRT DDR code 
Async. Data Comm DDR code 
Sync. Data Comm DDR codé 


Data Comm Communicate Handler 


Console Communicate Handler 


180 cps and 120 cps Serial 


Printer DDR code 


(Slice 31) 
MCP code 


(Slice 33) 
(Slice 35) 


(Slice 36) 


Indexed file Comm Handler 


ICMD DDR code 


Console Buffer data slice 


SCL Buffer data slice 
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THE PRINT OPTIONS (CONT.) 


3.4.7 THE PRINT SLICE OPTION (CONT.) 
If no <slice option is specified, then all the slices will 
be printed in the order in whichthey reside in the locked 
area, 
Items which may be included in the analysis of a 
loaded slice are: 
MAP RS - Slice Descriptor (see Table 6.3.1) 
FIELD S_ITLW.A. - &—interpreter Work Area (in program 
TCBs only) (see Tables 8.2.1 and 
823.1); 
FIELD CCBPA2 - COP table (COBOL/RPG CCBs only) 
FIELD CONTROL STACK - TCBs only (see table 7.4.2). 
MAP SD - Segment Descriptor (see Table 6.4.1) 
If the DATA.SEGMENTS option is selected then further items 
discussed in Section 8 may be encountered. 
3.4.8 THE PRINT TASK OPTION 
SS ee 
This command prints the contents of a Task Control Block 
(TCB) (see Section 8). The syntax is: 
PRINT TASK 


< task type > 


< task name> 
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THE PRINT TASK OPTION (CONT.) 


Options for ¢task name> include: 


BAILIFF 
MCS 


CURRENT 


¢task type) 


Slice 0, MCP code 

Slice 13, MPLII s-code 

Slice 14, NDL s-code 

Slice 15, MCP code (including LOADER) 
Slice 15, MCP code (including SCL) 


must be the mix number of a task in the 
range 0-15 


causes the printing of the task which was 
executing prior to the dump being taken. 
This is the task referenced by field EICT 
of map GLBLM (Table 7.6.1), and may be part 
of the cause of the dump. 


enables further analysis of the S-Interpreter 
Work Area (SIWA). If the option is not 
selected then the SIWA is printed as a single 
block of data. 


Options available include: 


COBOL 7 
RPG : 
MPLII : 
BIL 2 
SORT 
NDL 


COBOL S-machine (see Table 8.2.1) 


BIL S-machine (see Table 8.3.1) 


Sortintrins microcode (refer to MCP listing) 


NDL S-machine 


If no option is specified for the PRINT TASK 
command, then all tasks in the dump are printed. 


In addition 


to printing the TCB, the PRINT TASK 


option prints the associated Program Control Block 
(PCB) and Interpreter Control Block (ICB), wherever 


applicable. 


See section 8 for further details of 


these task structures. 
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THE PRINT OPTIONS (CONT.) 


3.4.9 


3.4.10 


THE PRINT.ALL MEMORY OPTION 


This option prints the entire contents of the 

memory dump. It is printed in a format equivalent to a 
command of PRINT GLOBAL PHT SLICE. Memory not in use 
is not printed. Although this option prints all of 
memory it is not recommended; selective options may 
considerably reduce the volume of printed output. 


NOTE: It is not sufficient to include only this printout 
when submitting problem reports. Useful information may 


be contained in memory areas not in use. This is especially 


true if memory links are corrupt. When submitting a 
problem report containing a memory dump, the complete dump 
on cassette, disk or load/dump tape should therefore be 
included. An accompanying listing of the PRINT MIX 

GLOBAL OL PHT option is useful for initial analysis. 


THE PRINT HEX OPTION 


This option provides the operator with a printout 
of selected areas of the dump file. The option has 
the syntax: 


ONE 


ONE : This option selects page one (extended) 
memory for printing. 


g¢starty : This parameter must be four hexadecimal 
digits long (no delimiters) and indicates 
the memory address of the first byte to be 
printed. 


<length> : This parameter must also be four hexadecimal 
digits long. It indicates the number of bytes 
to be printed. 


The contents of the memory dump are printed in hexadecimal 
and ASCII format. 
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4. INITIAL DUMP ANALYSIS 


This section discusses the approach to analysing memory dumps. 
Firstly, the type of problem must be identified. Once this 

is done, some general analysis should be performed which may 
lead to deeper analysis of selected parts of the dump. 


4.1 IDENTIFYING THE PROBLEM 


Problems can be partially analysed by considering the 
symptoms. The operating environment (what tasks/programs 
were running), and the configuration environment (what 
devices were in use) may indicate the general nature of 
the problem. First of all, the following categories 
should be differentiated. 


4.1.1 ALL PK-LIGHTS FLASHING 


This is known as the memory parity condition. 

It occurs when the processor fetches a byte from 
memory which has a parity error. In this situation 

a complete memory dump cannot be taken since the 
problem will occur again when the dump is being taken. 
However, a memory dump taken to cassette will proceed 
up to the bad memory address and therefore locate 

the problem. 


Note that memory dump files on disk are not initialised 
to any specific pattern; consequently, the end of the 
dumped information cannot easily be located on a 
MEMDUMP file. 


The memory parity condition may also be caused by a 
system software failure. The ROM at the low address 

end of memory contains a deliberate permanent parity 
error as a check on interpreter failures when accessing 
beyond segment boundaries. Therefore, if no memory 
hardware fault can be located, the current task should be 
analysed (see Section 4.2.2). 


2015400 


4. 


4-2 


4.1 


INITIAL DUMP ANALYSE (CONT.) 


IDENTIFYING THE PROBLEM (CONT.) 


4.1.2 


SOME PK-LIGHTS FLASHING 


When the MCP detects an irrecoverable error 
condition, it sets PK-lights 17 to 24 flashing 

in a pattern which identifies the problem. Refer 
to section 5.4 for details. 


If analysis does not reveal faulty hardware or 
corrupt media, further analysis may be performed 

to isolate the environmental conditions under which 
the problem occurred. If more than one dump with 
similar symptoms exist, analysis often gives a clue 
to the cause. 


INITIALISATION TO PK-LIGHTS 1 AND 2 


This is caused by the execution of the microcode 
@000000@, which passes control to the start of 

memory. The first thing to look for in a memory 

dump taken after this condition, is corrupted memory. 

If there appears to be no corruption, then a general 
analysis as discussed in section 4.2 should be followed. 


NO RESPONSE TO KEYBOARD INPUT (NO ACTIVITY) 


In this condition, the MCP gives no response to 
depressing any key, including the Ready Request-Key. 
This may be due to a peripheral problem, or the MCP 
might be in a tight loop. The global diagnostic area 
(see Section 7.4) should distinguish the two cases. 


Since the keyboard is associated with the console printer, 
a printer jam will cause this symptom. The PHT of the 
serial printer should be examined if this is a suspected 
cause of the dump. 


NO RESPONSE TO KEYBOARD INPUT (D-LIGHTS FLICKERING) 


It may not be possible to enter data orobtain a response 
from depressing the Ready Request-Key, but the system 
may still look "busy" because of D-light activity. 

This problem is often caused by system thrashing. 

This can result from an attempt to execute too many 
programs in insufficient memory, or an attempt to 
execute a program with exceptionally large segments. 

In this case, the organisation and contents of memory 
should be examined. 
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IDENTIFYING THE PROBLEM (CONT.) 


4.1.6 NO PROGRAM RESPONSE TO "GO" OR "DS" INPUT 


In this condition, no action appears to be taken by 

a program when a "GO" or "DS" message is entered for 

that program, although all other activity appears to 

be normal. This is usually caused by the program hanging 
on a dedicated peripheral (i.e. not disk). In this case 
the task status should be examined in the memory dump. 


PRELIMINARY INVESTIGATION 


This provides a Ree range ee information without producing an 


+ + 
excessive amount of pr inted oucpuc. 


4.2.1 HARDWARE STATUS 


The OL and PHT options of PMB80 print this information. 

It is recommended that a check is always made on the 
status of the devices involved in any problem (see 

section 9.2). An invalid status may not necessarily cause 
a system problem, but unexpected conditions may arise 
which cause a failure. 


The device status in the CT (PRINT OL option) is 

a logical status as seen by the MCP; this may not 
exactly correspond with the physical hardware status. 
The PHT holds the last status received from the channel 
controller. 


4.2.2 MEMORY ORGANISATION AND CONTENTS 


The PRINT MEMORY.MAP MEMORY. LINKS option of PMB8O 
provides a complete analysis of the layout of memory. 
Section 6 describes the format of memory with no error 
conditions. All reports of overlapping areas in 

memory should be investigated. If the Virtual Memory 
lock is held by a task (section 7.6.2), then overlayable 
memory may contain an invalid link. 


4-3 


4. 


4-4 


4.2 


INITIAL DUMP ANALYSIS (CONT.) 


PRELIMINARY INVESTIGATION (CONT.) 


4.2.2 


MEMORY ORGANISATION AND CONTENTS (CONT.) 


Shortage of overlayable memory may be the cause of a 
number of performance problems, especially system 
thrashing. If a dump is taken because of poor 
performance, then the amount of overlayable memory 
should be checked. For a rough guide, at least 10 KB 
is required as "free space" to enable virtual memory 
to perform efficiently. Large program code or data 
segments can cause similar problems. Although it is 
not possible to specify an exact limit, as a rough 
guide it may be stated that user program segments of 
4K bytes are too large, especially on the B80 in a 
multi-programming environment. 


Section 7 discusses the global maps; these should be 
checked for valid contents. 


The PRINT PHT option of PMB80 analyses the I-O descriptor 
queues. Since the queue heads lie at the high address 
end of memory, an incomplete memory dump will provide 

an incorrect analysis of this structure. 


MCP STATUS 


The status of the MCP when the memory dump was 

taken can be obtained from an analysis of the global 
maps (section 7). The diagnostic area in particular 
is designed with this purpose in mind. The analysis 
of the GLBLM MAP and TASK.TABLE (PRINT MIX option 

of PMB80) provides a general overview of the task 
environment. 


USER TASK STATUS 


Task structure analysis is provided by the PRINT 

TASK option of PMB80, and discussed in section 8. 

To avoid producing a large amount of printed output 
without much relevant information, it is recommended 
that the current task is analysed first. The current 
task is the task running when the memory dump was 
taken. The most important information, other than the 
integrity of the task structure, is the communicate 
parameter area. This indicates the latest call on 

MCP routines (open file, read etc.) that was requested 
from the task. 


SECTION 5 


5 SYSTEM REGISTERS AND TRACE DIAGNOSTICS 
The B80 MCP is written in microcode, consequently extensive 
reference is made throughout this newsletter to the hardware 
registers of the B80 processor. This section documents the 
format and usual contents of these registers. 
The B&O MCP provides a general trace facility controlled by 
the GT command. The trace is used for system fault diagnosis. 
Even when the trace is not in operation, a memory dump includes 
a historical buffer of one byte containing trace diagnostic 
information (see section 7.4). Sections 5.2 through 5.4 describe 
trace diagnostics. 
See. SYSTEM REGISTERS 
Table 5.1.1 shows the format of information in the 
processor registers, and their possible contents. 
Although a memory dump does not necessarily contain 
the contents of the registers at the time of the dump, 
the following points should be noted. 
The PHDMP MAP (Table 7.2.1) stores the current contents 
of the registers after two types of event. When a 
physical interrupt is received from an I-O channel, the 
processor executes the Master Interrupt Processor (MIP) 
section of the MCP. The registers are dumped on entry to 
the MIP in order that processing can resume, after the 
interrupt has been serviced, from the point of interruption. 
The registers are also dumped to the PHDMP MAP if the general 
trace is running (see section 5.2) or the system failed 
with a trace diagnostic (section 5.4). 
5.2 THE GT COMMAND 
The general trace command is an MCP intrinsic which displays 
various diagnostic information either on the system console 
printer or on a line printer. The format is: 
GT 
OFF 
< printer peripheral > 
< diagnostic class > < switch value > 
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SYSTEM REGISTERS AND TRACE DIAGNOSTICS (CONT. ) 


THE GT COMMAND (CONT.) 


The ON and OFF options switch the trace on or off 
respectively. The <printer peripheral> selects the 
device to print any trace messages. If this device 

is currently in use, the trace messages are interleaved 
with other printed output. Table 5.2.1 shows the 
<diagnostic class>es which are further explained in the 
sections which follow. 


The MCP contains calls to the trace routine throughout 
the code. However, trace diagnostics are printed only 
when two conditions are fulfilled; (a) when the trace 
is switched on, and (b) when the level of the switch 
value for that class is less than or equal to the level 
of the trace point. The <switch value> consists of two 
hexadecimal digits, with the following meanings: 


first digit : switch value for register diagnostics 
second digit : switch value for memory diagnostics 


In addition to providing a printed trace of selected 
trace points, the general trace displays a one-byte 
diagnostic (the contents of the AD register) on PK lights 
17 to 24 (PK17 corresponding to the most significant bit 
and PK24 the least significant bit. If the PK light is 
lit, the corresponding bit value is 1. These lights 
display the last trace point encountered if the trace 
option is switched on and the keyboard is not enabled 
for input. 


TRACE DIAGNOSTICS 


Trace information provided by the B80 MCP consists of 
three parts: 


register diagnostics 
memory diagnostics 
one-byte diagnostics 


Register diagnostics are made to a selected printer and 
the contents of the registers are entered in PHDMP (table 
7.2.1) when the trace is switched on and the switch value 
is lower than the trace point value for that class. 
Memory diagnostics are made to a selected printer when the 
same conditions are satisfied. One-byte diagnostics are 
displayed on PK lights 17 to 24 whenever the trace is 
switched on and the keyboard is not input enabled. The 
most recent one-byte diagnostic processed by the MCP can 
be found in the field DIAGCIRC of map DIAGCBUF (Table 7.4.1) 
regardless of the state of the trace or switch values. 
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TRACE DIAGNOSTICS (CONT.) 


Printed register diagnostics have the following format: 


register AD BO BIFL B32 J K L 
contents XX XX XXXX XXXX XXXX XXKX XXXX 


M1 M2 WR x Y AD,ESCT 
XXXX XXXX XXXX XXXXXXXX XXXXXXXX XXXX 


{the actual print is on one line). AD contains the one-byte 
diagnostic consisting of two hexadecimal digits. The first 
digit represents the diagnostic class (see Table 5.2.1) the 
second digit represents the diagnostic severity value which is 
compared with the switch value set by the GT command. ESCT 


is the one byte task-id (Table 7.6.2) of the currently 


VA 


executing task (as displayed on the keyboard D-lights) . 


A general rule on the interpretation of the diagnostic 
severity value is the following: 


O (zero) is the least important 

B is used when a module is entered (eg: DB-= VM module entry) 

E is used when a module is exited (eg: EE= EPAR module exit) 

F is associated with an error condition (not necessarily fatal) 


Actual details vary according to the coding of the various MCP 
modules. 


Sedek FILE OPEN AND CLOSE - CLASS 0 


These diagnostics are issued by the OPENCLOSE MCP 

slice 17, which performs operations requested by a 

task via the communicate mechanism. There are so 

many possible interpretations of each severity value 

that it is not possible to give a guide to interpretation 
of register diagnostics beyond OB = entry and OE = exit. 
Memory diagnostics in this class often print a DFH, 

an FIB or an FPB. 


If class 0 diagnostics appear in DIAGCIRC it is possible 
that the problem is related to opening or closing a file. 
Possible faults include media corruption (disk directory, 
program S-code files), or memory corruption of the FPB. 
These possibilities may be checked from a memory dump or 

by running utilities such as KA and CHECK.DISK. The 

task which initiated the operation may hold one of the 
openclose locks (see section 7.6) and the task's communicate 
area (in SIWA) will indicate a verb of Ol = open or 

02 = close (see table 8.4.1). 
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5.3 TRACE DIAGNOSTICS (CONT.) 
5.3.2 INDEXED FILE HANDLING - CLASS 1 


These diagnostics are issued by the MCP index 
communicates slice 31. A value of 1B indicates 
slice entry, and 1E indicates slice exit. This 
slice performs operations requested by a task via 
the communicate mechanism. 


Eerie ACCEPT/DISPLAY/DATE/TIME - CLASS 2 


These diagnostics are issued by the MCP SPO slice 19 
which processes communicates with a verb in the range 
@10@ - @20@ (see Table 8.4.1). 


5.3.4 INTRINSIC UTILITIES - CLASSES 3-7 


The SORTINTRINS microcode uses these classes. 


5.3.5 AUTOMATIC VOLUME RECOGNITION - CLASSES 8-9 


Class 8 diagnostic is used by the general AVR routine 
(OPENCLOSE segment 18); class 9 is used specifically 

by the routine which "tidies up" a disk directory at 

AVR time (OPENCLOSE segment 19). If AVR entries 

are found in DIAGCBUF of a memory dump, it is quite 

likely that the problem has been caused by faulty hardware 
or media. In addition to recognising newly loaded media, 
the AVR routine is used when certain exceptionai events 


As omhie ale 


occur on hardware channels. 


5.3.6 DISK SPACE ALLOCATION/DE-ALLOCATION - CLASS A 


This class of diagnostics is issued by OPENCLOSE segments 
20 and 21 which perform the disk space allocation and 
de-allocation functions respectively. (see Table 5.3.6). 


een, INTERPRETERS - CLASS B 


This class of diagnostics is reserved for the 
interpreter microcode. However, only the BILINTERP 
(MPLII program interpreter) uses the facility 
extensively. 


This class of diagnostics is very useful tracing an 

MPL program. See table 5.3.7 for the details. Note 
that BB and BE do not indicate interpreter entry and 
exit in this case. 
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TRACE DIAGNOSTICS (CONT.) 


5.3.8 COMMUNICATE HANDLING - CLASS C 
eS NNN 


The global MCP routine for decoding all communicates 
from tasks uses this class of diagnostics. See Table 
5.3.8. 


Pal 
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VIRTUAL MEMORY - CLASS D 


The Virtual Memory (VM) routine uses this class of 
diagnostics. A trace of the virtual memory operations 
is not generally needed as a lot of detailed analysis 

is involved. However, when a disk problem occurs the 
VM routine is often the first part of the MCP to 

detect the error. This is the reason why the DF failure 
diagnostic (section 5.4.2) is often encountered. 


5.3.10 TASK CONTROL (EPAR) ~ CLASS E 


There are not many trace points with this class. Most 
important is the EE diagnostic, issued when the task 
schedules are exited. This indicates which task has 
been entered and which code is currently executing 
(see section 7.4). 


5.3.11 INPUT/OUTPUT QUEUE HANDLING - CLASS F 
atchial sibeciocieert_ atch ste : : 


of I-O descriptors, and the waiting of tasks on 
these I~O operations. In the register diagnostics 
the registers hold the fields of the I-0 descriptor 
being queued. (See Table 5.3.11). 


FAILURE DIAGNOSTICS 


When the MCP discovers that an irrecoverable error has 
occurred, it issues a failure diagnostic. On previous 
systems this was a printed trace diagnostic. On release 3.0] 
a failure diagnostic is a pattern of flashing PK lights. 

PK lights 17 to 24 show the one-byte diagnostic of the 
failure with PKs 17 to 20 showing the diagnostic class. 


When this situation occurs, a memory dump should be taken 

(see section 2). The PHDMP MAP (Table 7.2.1) contains the 
contents of the processor registers at the time of the failure. 
The value of the one-byte diagnostic indicates the rough 
nature of the problem; the contents of the registers give 
more specific information. 
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FAILURE DIAGNOSTICS (CONT.) 


AC, AD (PK patterns 10101100, 10101101) 


AC and AD on PK lights 17-24 indicate a fatal error 
detected while allocating or de-allocating disk file 
space respectively. The Ml register holds the memory 
address of the last disk I-O descriptor and BO holds 
IODFL (see Table 9.3.4). This problem is usually 
caused by disk hardware or disk media problems. 


DF (PK pattern 11011111) 


More than one type of error is detected by the VM 
subsystem. These are distinguished by the contents 
of the Ml register (see Table 5.3.9). 


If Ml=1111 or 5555, an I-O error has been encountered 
on a virtual memory operation. Refer to the VM 1-0 
descriptor (field VMIOD of MAP VMWA, Table 7.5.1). 
This indicates a problem with the disk drive or disk 
media. 


If M2=2222, then the MCP has attempted an invalid 

"put segment" operation. If Ml=FFFF then an unconditional 
"get" operation has failed (not caused by an I-O error). 
If either of these problems persists after the system 
(including user programs) has been recovered from backup 
copies, then a fault may exist in the MCP and should be 
reported. 


EF (PK pattern 11101111) 


Different errors identified by this failure diagnostic 
are distinguished by the contents of the Ml register 
(see Table 5.3.10). If any of these problems persist 
after the system has been recovered from backup copies, 
then the problems should be reported. 


FF (PK pattern 11111111) 


This error diagnostic is used to show errors in 
peripheral handling. The WR register identifies 
the device type involved (see Table 5.3.11). The 


PHT entries for the device should be checked for a 


bad status condition (section 9.2). This may identify 
a hardware fault. I£ no hardware fault is locatec, 
the problem should be reported. 
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TABLE 5.1.1 - SYSTEH REGISTER USES 


RES 


“Wi 


BD 
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FORMAT 


1 BYTE 


i BYTE 


2 BYTES 
2 BYTES 
2 GYTES 
@ BYTES 
2 BYTES 


2 BYTES 
2 BYTES 


£ BYTES 


1 BYTE 


USE 

(i) I-D channel address (see TABLE 9.2.23 

€i4) Gne byte diagnostic class and caverity value 

ustialy contains a fiag byte according to the situation t- 

(i) peripheral status byte (see TABLES 9.2.4 to 9.2.8) 

(it) BRR s-flags (see TABLE 9.2.9) 

(iii) I-f descriptor flags (sea TABLE 9.3.4} 

(iv) slice descriptor flags (see TABLE 4.3.2) 

{v} segment descriphor flags (see TABLE 6.4.2} 

tuo (usualy independant) bytes used for flags as 80 

a two byte work araa ar a memory address 

used for storing a memory address 

a memory address :- 

(i) addrsss of the task slice descriptor on exit from EPAR (SECT 7.4) 
(if) address of the PYT when MIP is handling an interrupt (SECT 9.2) 
(i) mamory addrass of a table invotved in data sovement 

(ii) used in diagnostics as a further indication of the type of error 
as Ml 

(1) separate 1 byte work areas 

(ii) used by the diagnostic routine as for Mt 

(i) segment descriptor for virtual memory operations 

(ii Communicate Parameter Area on entry to #CH 

this ts not a processor register but is the last two digits 

of a trace diagnostic. If is the task-id byte of the current task 
See SECTION 7.4 


SYSTEM REGISTER USES 
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TABLE S.2.1 - TRACE PLGNOSTIC CLASSES 


CLASS USE 
fite OPEN and CLOSE (HCP stice number 17} 

INDEXED file communtcate handling (NEP stice 31) 

ACCEPT, DISPLAY, BATE and TIME communicate handling (slice 19} 
used by SORTINTRINS 

Automatic Volume Racognition (AYR) (HCP task 9, and slice 47} 

AVE and BALLIFF (MEP task @} 

disk space ALLOCATION and BE-ALLOCATION (sticea i7 segsents 20, 21) 
INTERPRETERS (mostly SILINTERS? 

COMMUNICATE handling (HCH in gtobal MEP, and BRR stices} 

Virtual Memory cparations (gfobal MCP) 

Task contro! (EFAR ta global MEP) 

I-8 queue handting (global MCP) 


~~ 


“TET ES Oy Oo Te NO OG Gh re 


tae me meester eee eee 


TRACE DIAGNOSTIC CLASSES 


TAELE S.d.1 - CLASS 0 - FILE OPEN AND CLOSE 


DIAG INFORMATION 


Of entry into ona of the open or close routines 
CE exit from one of the open or clase routines 


TABLE 5.3.2 - CLASS 1 - IMPEYED FILE communreaT 


Tat CO te eZ ve TAVIS EOE 68 


i 
od 
a> 
= 
wa 


DIAG INFORMATION 


10 deleted entry found, or end of area entry found 

iis suspending the operation 

12s searching through the kays 

13 comparing the keys 

14 = set up overflow region search buffer 

5s set up index region search buffer 

14 access work area key 

1? filt the entry (HRL = key entry size? 

i@ ss store the entry (WRL = key entry siza} 

1? end of the free slot stiding the buffer up 

JA se call MIP to queue the I-D descriptor 
BO=1ODDU (E=writs, Feread) (TABLE 9.3.3) 

1B sentry into the index comms routine 
BO=URL=communicate verb, Bis IFLAGS 

WE exit from the index comms routine 
Bi=FILESTATE (TABLE 8.4.3) 


CLASS O - FILE OPEN AND CLOSE and 
CLASS 1 - INDEXED FILE COMMUNICATE HANDLING 
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YAELE 5.3.3 - CLASS 2 - ACCEPT, DISPLAY, DATE AND TIME 


DIAG INFORMATION 

ori~24 BISPLAY comaunicate executiaa 

27-28 ACCEPT communicate execution 
TIME and BATE communicate execution 
entry into the CLASS € Communicate handling code 
exit from the roufine 
error conditions 
BO, HR=Fetch Communicate Message (TABLE 6.4.2) 
RIO=FFFF => fatal error 


TASLE 5.3.4 ~ CLASSES 3-7 - INTRINSIC UTILITIES 


No information 


en 


CLASS 2 - ACCEPT, DISPLAY, DATE AND TIME and 
CLASSES 3-7 - INTRINSIC UTILITIES 
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TABLE 5.4.5 - CLASSES §-? AUTONATIC VOLUNE RECOGNITION 


PIAG INFORMATION 


& set up disk configuration table 
Be XY=MFID 
& update the I-0 @ head flags in the PHT 
ME->PHTH, WRL=CTQHDO 
5 = BPR found on non-disk AYR 
KeH2=DOR stice number 
8S used in DISK AYR 
87 —s device not in usa 
M-DOFL 
88 = device in use 
8? so grepare READY/NOT READY aessage 
GA start the AYR operation 
Bi=QFL, M1->PHTHD; YRL=PHTMQNO 
tH == AVR code entry, look for the channel requiring help 
PE oaxit from AYR routine 
& 1-0 error during AVR 
97 search Bisk File Headers and set usercounts to zero 
“Gs search NAMELIST for temporary entries 
WA enter final phase of disk directory cleanup 
9B oenter disk directory cleanup routing 
SE exit cleanup, retinquish the opeuctose fock and retura to caller 


BAILIFF BIAGNOSTICS 


ee ae A ae es ee ae ees we er a Hae Oe 


in n GETSLICE sans WRL=SUA PONT 
in PUTSLICE operation BO=SWAPCNT 
BETSLICE operation after the slice lock has been procured 
PUTSLICE operation after the slice lock has been procured 


CLASSES 8-9 - AUTOMATIC VOLUME RECOGNITION 
er RL 
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TABLE 5.3.6 - CLASS A - DISK ALLOCATION AND DE-ALLOCATION 


BIAG INFORMATION 
Al Bi=DDU (disk unitd, WR=BDA (disk address} 
fe initiate disk I-98 
BisBDU, OFC=1ODFL (1-0 descriptor flags), WR=EBA 
M%  B32=BFH bitaag 
5 B3e=size of area 
“? = exit no space, BO=BDU, X¥=size required 
a determine the area required 
fo de-allocate fatal faitura, BO=IODFL, MI->IODFL 
FB allocate fata! failure, BO=IGBFL, Mi->TODFL 
ro exit from the allocate sr de-allacaba routine 
ra allocation or de-allocation failure (no user disk? 


TABLE 5.3.7 - CLASS 8 - BILINTERP DIAGNOSTICS 


DIAG INFORMATION 
BB souser generated communicate 
associated menory trace prints the CPAa 
BO socal of a procedure within the current segment 
H=pracedure numberisegment number of the called procedure 
BD so procedure raturn 
Bue=procedure nuabertsegment number of the procedure returned ta 
bR=byte offset (byte reversed) in procedure 
BE secatf of procedure in another segment 
Me=procedure nuabertsegaent nuaber of the called procedure 
fH = soDS/ DP error 


CLASS A - DISK ALLOCATION AND DE-ALLOCATION .and 
CLASS B - BILINTERP DIAGNOSTICS 


eR tt rr ee Tree en er eng ener eens 


face tenteeteemennemetnemeeennrenn eters nen TS 
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TABLE 5.3.8 - CLASS C ~ CONHUNICATE HANDLING DIAGNOSTICS 


BIAG 


#E2E 49 


Mm & 


oH 


INFORMATION 

start of class A comm processing 

BO=varb (TABLE 8.4.13, BIsFILESTATE (TABLE 8.6.3} 
bRL=fitetechnique (TABLE 8.6.4), B32~5C0PA 

start read-write sequential and stream buffering ahaad 
BOrfitestate, Xi=verb, Ei2=buffer tength, BL=IDDFL (TABLE 
previous buffer = current buffer 

full buffer foun on sequential read 

Bl=fite technique, M2->IGDCL (TABLE 9.3.3) 

zera a buffer 

mark buffers as empty 

taiciiiate the disk address 

BO=disk unit, Gl=area number, B32=sector address 
return from buffer search 

bLs86 (found), 81-60 (not found) 

conditional failure due to buffer wait 

suspension of the comm waiting on 1-0 

call on I-f queue handier to queue an 1-0 descriptor 
start of conmunicate handling code 

BSe-2CPA, XY=CRA (byte raversed) 

successful termination of a class A communicate 


F364) 


K-OFIB, and associated memory diagnostic prints FI8 and buffers 
exit from NCH non-class A sequential organisation comaunicate 
Ele and WR = top of controt stack return iafo (TABLE 7.4.2} 


communtcate farture 
BL, WR=Febch Communicate Hessage (TABLE 8.4.2) 


CLASS C - COMMUNICATE HANDLING DIAGNOSTICS 


1 NEE T OT OOE APCD ce 9 ta 


TABLE 5.3.9 - CLASS BD - VIRTUAL NEMORY DIAGNOSTICS 
WAG INFORMATION 


DO 3s start to search memory for space 
Me=start searching address 
fis consider the segment 
M=currant address 
Pe = space found at fast BL diagnostic 
set up the sagment descriptor 
ti=start of area, M2=length of the segment, BO=SDFLAG (TABLE 4.4.2) 
i adjust the memory tink 
i wake an area of nemory available 
Micstart address, WR=length 
BS start virtual memory I-0 
Me=base, K=length, WR=disk sector, Bl=disk unit 
PO=apcede (@E?Gsurite, @FPrread} 
RY = ware areas feft to purge 
Messtart address, WR=tength, Biesegnant descriptor flags 
te core to care aove 
Misoidbase, M@-newbase, WR=tengéh (40 for stide down) 
PS entry into the virtual aemory routine 
he- Segment dasctiptor, X¥=SB (TARLE 4.4.2) 
Mi=2222 inplias a segment (not stice) operation 
M betstice failure and thrashing detection 
TE so exit from the virtual memory routine 
Me->SB, XY=SD (byte reversed) 
het inplies faiture 
IF —s virtual aemory fatal error 
He~>SB, XY=Sb (byte reversed) 
Mi=iiii virtua! memory 1-0 error BisIQRFL 
Mi=2227 svstem error 
bL=4444 SBBASE dogs not point fo tinkt? (mewory link error) 
ML=3955 as for Hi=iLit 
MUSFFFF system error 


CLASS D - VIRTUAL MEMORY DIAGNOSTICS 
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TABLE 5.9.10 - CLASS E - TASK CONTROL DIAGNOSTICS 


BEAG INFORMATION 
EB sentry into System Control! Language decoder 
L-DICh of originator 
ED stice usercount overfiow 
EE oaxit from epar into the currant task 
XYstop of stack (TABLE 7.4.2) 
d-microcode segaent base, L-stice descriptor, M->tap af stack 
fF =e fatal error 
ME=9S9? sayment usercount errar datected on FUTSESG 
MI=AAAA atbenpt to use an absent siice 
MI=BEEE errar in SCL interpreter 


TABLE 5.3.41 - CLASS F - INPUT-OUTPUT QUEUE HANDLING BIASNOSTICS 


IMAG INFORMATION 
for all of these diagnostics except FF the registers hold t- 
BOFTQDEU, BisIGDFL,; B32->IODFL, MI=IODDA, ME=IOBBL (see TABLE 9.3.9) 
Fos unconditional wait on axit after call fron HCH 
FS conditional wail on exit after call from MEH 
F4 no Wail on exit after non-disk descriptor inserted 
F& = unconditional wait after ron~disk descriptor inserted 
F7 ~—s conditional wait after non-disk descriptor inserted 
FS no Wait on axit after disk descriptor insert 
FA unconditional wait on exit after disk descriptor insert 
FG conditional wait on exit after disk descriptor insert 
FF fatal BBR errar 
Mi=0000 invalid disk wnit in I-] descriptor SO=10DRY 
BR=8888 fata comm PER error 
BR=S79? self scan BRR arror 
WREEFEE disk GER error 


CLASS E - TASK CONTROL DIAGNOSTICS and 
CLASS F - INPUT-OUTPUT QUEUE HANDLING .DIAGNOSTICS 
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SECTION 6 


6. MCP STRUCTURE AND MEMORY ORGANISATION 


It is often necessary to know where certain items may be found 

in memory. Corruption of memory is one of the more common problems 
encountered in an MCP. On some dumps an area of memory is 
over-written with invalid information; on other dumps, just 

one or two critical bytes holding a memory link (address to 

another item) are wrong. PMB80 may be unable tn analyse satis- 
factorily a MEMDUMP file containing invalid memory links, since 

it assumes the memory structure is correct. This section provides 
sufficient information to enable a HEX dump to be analysed. A hex 
dump is obtained by the PRINT HEX option of PMB8O. 


6.1 AREAS OF MEMORY AND THEIR USES 


The six areas of memory used by B80 3.01 MCP are shown in 
Figure 6.1.1. 


The Read Only Memory (ROM) which has addressed @0000@ to 
GOFFF@ contains interrupt handling routines. It appears 
full of binary zeros on a hex dump. 


the contents of those areas of memory specified in table 
6.1.1. These areas do not contain information which is 
important for dump analysis. 


The other five areas are discussed in sections 6.2 to 6.6. 


6.2 RESIDENT AREA AND GLOBAL MCP 


This contains the global MCP code and data, which does not 
change location while the system is running (see Figure 6.2.1). 
This area of memory contains: 

Global tables (discussed in section 7) 


Global MCP routines: 


Master Interrupt Processor (MIP) 
Master Communicate Handler (MCH) 
Virtual Memory (VM) Handling code 
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MCP STRUCTURE AND MEMORY ORGANISATION (CONT. ) 


RESIDENT AREA AND GLOBAL MCP (CONT.) 


Global MCP routines: 


Task Structure Switching (EPAR) 
Slice Address Table (SAT) 


Each item is located at a fixed address and the same 

table or code segment can be found at the same address on 
all dumps for the same level of MCP. The code routines are 
not analysed by PMB80. The addresses of the tables may be 
found from either an MCP listing or a correctly analysed 
dump. 


6.2.1 SLICE ADDRESS TABLE (SAT) 


The SAT is a table of memory address of the next 
section of memory. Each memory address is two 
bytes long and addresses the first byte of the 
Slice Descriptor of a slice in the locked area. 
See Table 6.2.1, SATM MAP, and figure 6. nee 


analysis of the SAT is obtained by 
option of PMB8O. 


KED ADRON RATT arr a 
LOCKED AREA AND SLICES 


The Locked Area of memory follows directly after the SAT. 
The first slice (the BAILIFF) is at the same memory address 
on all dumps of the same version of the MCP. 


In the locked area, slices are contiguous with no intervening 
areas. Slices may be either present or absent (swapped out). 
If a slice is swapped out, only the slice descriptor remains 
in memory. When a slice is swapped in or out by the BAILIFF, 
all other items in the locked area are moved up or down in 
memory so that all slices remain contiguous. 


An analysis of the layout of memory is obtained by the PRINT 
MEMORY .MAP option of PMB8O. 


6. MCP STRUCTURE AND MEMORY ORGANISATION (CONT. ) 
ee ee eee 


6.3 LOCKED AREA AND SLICES (Cont'd) 
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6.3.1 SLICES 


6.3. 


2 


A slice is a body of code or data which provides 

a specific function. Examples of slices are: 

the MCP routine to handle the SPO (slice 19), the 
data comm message buffers (slice 34), the data 
associated with a task (program) in the mix 

(slices 1-14), or the code associated with a task 

in the mix (slices 39-49). A slice does not necessarily 
contain its own data, but rather controls access to 
its data which is located in the overlayable area of 
memory. The different types of slices have several 
features in common. 


The first ten bytes of each slice is a slice 
descriptor (see Table 6.3.1, RS MAP). This descriptor 
contains information about the status of the slice 
(SDFLAG, SDUSRS), the size and location of the disk 
copy (SDLENG, SDDKAD, SDDKSC, and SDUNIT) and the 

PINK LINK. 


The slices are linked together in the order in which 
they reside in memory. This is not in slice number 
order, the order of SAT. The PINK LINK is the memory 
address of the first byte of the next slice descriptor. 
This scheme of linking the slice descriptors is used to 


relocate memory slices when slices are swapped in or out. 


A slice is either a Code Control Block (CCB) or a Task 
Control Block (TCB). A CCB may be a Device Dependent 
Routine (DDR), a Function Dependent Routine (FDR), an 
Interpreter Control Block (ICB) or a Program Control 
Block (PCB). A TCB holds the control information for a 
task. 


DEVICE DEPENDENT ROUTINE (DDR) 


Each hardware device (disk, cassette, line printer, 
etc.) supported by the B80 has a section of MCP code 
which handles all features unique to the device. 

This code is accessed through a DDR slice. Each 
different device type has its own DDR with its corres- 
ponding slice number, and its entry in the SAT. 

For example, the DISKDDR is slice number 22 with an 
entry in SAT at offset 44 (@2Cc@). 
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MCP STRUCTURE AND MEMORY ORGANISATION (CONT.) 


LOCKED AREA AND SLICES (CONT.) 


6.3.3 


6.3.4 


6.3.5 


FUNCTION DEPENDENT ROUTINE (FDR) 


Part of the MCP code is divided into units each of 

which performs a specific set of functions. The code 

for each unit is accessed through a slice. Examples of 
function dependent routines are the indexed file 
communicate handler (slice 31), the open/close communicate 
handler (slice 17), and the warmstart slice (slice 18). 

In addition to these slices for accessing MCP function- 
dependent code, there are slices which hold buffers, for 
example: the data comm message buffers (slice 34). 


INTERPRETER CONTROL BLOCK (ICB) 


The code for an interpreter is also accessed through 

the slice mechanism. An interpreter slice, however, 

does not have its permanently allocated slice number 

and corresponding entry in the SAT. Interpreter slices 

are classifed as user slices and take a slice number 

from the pool of available entries at the top of the 

SAT. Unfortunately, this makes it difficult to distinguish 
program code slices from interpreter code slices when 
analysing dumps. The task structures, (see section 8), 
allow these slices to be distinguished. 


It should be noted that if an interpreter is located 
in extended memory then it is allocated a permanent 
slice from the available pool and the slice is 
located directly following the BAILIFF and AVR slices 
in the memory map. If the interpreter is not loaded 
into extended memory at warmstart time, then its 
slice is created and released whenever programs which 
require the interpreter are loaded or terminated. In 
this case the interpreter slice is loaded after a TCB, 
and resides next to the Program Control Block. 


PROGRAM CONTROL BLOCK (PCB) 


Program code is accessed through the data segment 

table located within this locked slice. For COBOL and 
RPG programs the COP Table is also located within the 
task's PCB. PCB slices are user slices and take a slice 
number from the pool of available entries at the top of 
the SAT. 


6. MCP STRUCTURE AND MEMORY ORGANIZATION (CONT.) 


6.3 LOCKED AREA AND SLICES (CONT.) 
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TASK CONTROL BLOCK (TCB) 


The TCB is the slice which holds the control information 
for a task. Its contents are discussed in detail in 
section 8. 


Each TCB has a slice number which corresponds to the mix 
number of its task. It addresses the corresponding PCB and 
ICB, and holds the CONTROL STACK which contains MCP 
restart information. The data segments for a program 

are accessed through the Data Segment Table held within 

the TCB. 


DATA SEGMENT TABLE (DST) 


A locked slice does not usually hold all of the code 
or data identified with the slice. Most slices 
contain a Data Segment Table (DST). The DST isa 
table of segment descriptors (see table 6.4.1 SD MAP) 
giving the address of the associated code on disk, 
and also the memory address if the segment is present 
in main memory. 


The absolute memory address of the DST is held in bytes 
offset 14 and 15 (reversed) of the locked slice (see 
Tables 8.2.1 and 8.3.1). All items in the dump that 
locate other information in memory have now been 
described. 

EXAMPLES OF HOW TO LOCATE ITEMS 

Locate data segment 9 of a program running with mix = 4: 


a) Find the SAT (Fixed memory address) . 


b) The address of the TCB slice descriptor is at 
byte offset 2 x 4 = 8 and is byte reversed. 


c) The address of the DST is in bytes 14 and 15 of 
this slice (reversed), (Tables 8.2.1 and 8.3.1). 


dq) The segment descriptor is located at byte offset 
8 x 9 = 72 in the DST, and is 8 bytes long. 


e) The first byte of SD determines whether the segment 
is in memory, (Table 6.4.2) 


f) Bytes offset 1 and 2 (reversed) give the memory 
address of the segment, (Table 6.4.1). 
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MCP STRUCTURE AND MEMORY ORGANISATION (CONT.) 


6.3 


LOCKED AREA AND SLICES (CONT.) 
6.3.8 EXAMPLES OF HOW TO LOCATE ITEMS (CONT.) 


Locate the COP Table of a program running with mix = 3 
(COBOL/RPG programs only): 


a) Find the SAT (Fixed memory address) 


b) The address of the TCB slice descriptor is at 
byte offset 2 x 3 = 6 and is byte reversed. 


c) Byte offset 1 of the slice gives the index into 
the SAT for the PCB memory address (Table 6.3.1). 


d) The COP Table is located in the PCB at the memory 
address held in bytes offset 10 and 11 (reversed) 
(Table 8.2.1). 


OVERLAYABLE AREA AND SEGMENTS 


Above the locked memory area is the overlayable area. PTRX of 
MAP VMWA (Table 7.5.1) addresses the first byte and PTRZ the 
last byte of this area. To obtain an analysis of the structure 
of this area use the PRINT MEMORY.LINKS option of PMB8O. 


The overlayable area contains code and data segments and may also 
contain available memory areas. All segments are accessed through 
the slice structure and Data Segment Tables as explained above. 
Available areas are also treated as segments and have a segment 
descriptor (with flags = @00@) in the first eight bytes of the 
area. 


The segments in the overlayable area are linked together in 
the following manner (see figure 6.4.1). The first two bytes 
addressed by PTRX provide the memory address of the segment 
descriptor for the first segment in the overlayable area. 


This segment descriptor contains the absolute memory address 

and length of its segment. Immediately following this segment 
in memory, the next two bytes hold the memory address of the 
segment descriptor of the second segment in the overlayable area. 
This is repeated until the memory addressed by PTRZ is reached. 


If an available area is shorter than ten bytes in length (two for 
the memory link and eight for the segment descriptor), then it is 
filled with binary zeros. A link with the first byte @00@ is 
invalid because this would point to ROM, and the virtual memory 
algorithms recognise that this byte is a filler, not a memory 
link . 


6. MCP STRUCTURE AND MEMORY ORGANISATION (CONT. ) 
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PHT AREA 


The Peripheral Handling Table (PHT) area is located at the top 

of page zero of memory. The contents are analysed by the PRINT PHT 
option of PMB80. The area contains tables of information used by 
the Master Interrupt Processor (MIP) and DDR code. Each table is 
loaded into memory at warmstart time and remains at the same 

memory address throughout the session. The Tables are addressed 
by the field PHT.ADDR.TABLE of MAP PHDMP (Table 7.2.1). The 
contents of these tables are discussed in more detail in section 9. 


EXTENDED MEMORY 


(Page 1) memory may contain oniy a few selected 
items. To determine which items are in extended memory, 
use the PRINT MEMORY.MAP option of PMB8QO. 


Any or all of the interpreter segments, the index communicate 
handler segment, or the data comm message buffer segment may 
be held in this memory. If a slice is located in extended 
memory, then all segments of that slice are included in the 
extended memory. 


The segments (excluding data comm buffers) are loaded at 
warmstart time as specified by the SYSCONFIG file and subject 

to there being sufficient extended memory space. These segments 
then remain at their allocated memory locations for the entire 
session. 


6—7 


obo AREAS OF MEMORY 


@0000@ 
@1000@ 4KB 


RESIDENT AREA 


(3.01) @32DBG 13KB 


LOCKED AREA 


to floating 
OVERLAYABLE AREA 


~ 63KB 


PHT AREA 


@FFFF 64KB 


@0000@ 


EXTENDED MEMORY 


(PAGE 1) 
@3FFF 
or 
@7FFF 
or 
@BFFF@ 48KB 
or or 
@FFFF@ 64KB 


AREAS OF MEMORY 


6.2.1 RESIDENT AREA LAYOUT 


@1000e WM2GLOBAL SET UP BY 
eee [____mirwTay J fsoorsrae 
@100E@ DEBUG.GLOBAL 
i aa 
erneee [___—eesraces J 
eee | STUFF t~‘“‘CSOC*@S 
bal suche DC.PATCH 
@10BE@ PHT AREA 
4 
me VERSIONINFO 
@ 
e DIAGCBUF 

Oe late SNe rae ea 
ernpee [seu suis 
e1sige | _____OSK.RETRIES 
ising toa OCINEO. 

MIP 

I-O Q HANDLER 

MCH 

READMWRITE SEQUENTIAL 

READ//WRITE RANDOM 

READ/WRITE STREAM 
@3279@ 

LOCKED AREA 

@32DBe 


LOCKED AREA 


RESIDENT AREA LAYOUT 
pes aca hci oe aml terete tact oh 
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TACKEND ARFA LAYOUT 


| RESIDENT AREA 


OVERLAYABLE 


| 
| 
| AREA 
| 
| 
| 


LOCKED AREA LAYOUT 


6.4.1 OVERLAYABLE AREA LAYOUT 


| LOCKED AREA | 


PTRX of VMWA 


AVAILABLE 


PTRZ of VMWA 


PHT AREA | 


OVERLAYABLE AREA LAYOUT 
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6.5.1 PHT AREA LAYOUT 


| OVERLAYABLE AREA | 


one for 
each 
disk 
drive 


KEB.INT.BUFF 


— 
= 


PHT.ADDR.TABLE EREROR disk 
PHTH ene 
of MAP PHDMP 


PHTXPANSEP 
PHTH 


serial printer 
PHT 


geysers 
PHT 


high address end 
of page 0 


PHT AREA LAYOUT 
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EXTENDED MEMORY LAYOUT 


DST 


@0000@ 


AVAILABLE 


EXTENDED MEMORY LAYOUT 
a EE 


MEMORY 
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TABLE 6.4.1 - LOCATIONS IN MEMORY DESTROYED BY BOOTSTRAP 


MEMORY ADDRESSES 
10008 - @10GER 
@1030@ - @103F@ 
10708 - G107FR 
@0008 - @25558 


LOCATIONS IN MEMORY DESTROYED BY BOOTSTRAP 


TABLE 6.2.1 - SATH MAP (3.01) - SLICE ADDRESS TABLE 


OFF LEN 
SeT GTH FIELD FORMAT 
6 - QOSRCSN memory addresses of slice descriptors LABEL 
QO 2. BLFSN BAILIFF Task Control Block (TCB) addess AA BR 
@ 14 TSKiSN addresses for aix numbers 1-8 (TCBs) . 
18 & AVRSN Automatic Volume Recognition (AVR) TCB address : 
and utility mix numbers 10-11 TCB addresses - 
% 2 SUN SYS-SUPERUTL (mix=12) TCB address 7 
26 2 MCSSN Message Control System (MCS mix=13) TCB address i 
2 2 NDLSN Network control program (mix=i4) TCB address , 
3 2 LBRSN program LOADER (mix=15) TCB address by 
32 2 SWABS absolute memory address stat . 
used for entry to global MCP code - 
% 2 BADPSEC - 


- 
= 


OPCLON OPEN-CLOSE-AVR code stice address 

INITSN WARNSTART-INITIALISE code siice address 

DISPSN BISPLAY-SPO code slice address 

LPRSN LINE PRINTER DDR cade slice address 

CSTRSN CASSETTE DDR code stice address 

DSKRSN DISK DDR code stice address 

SEPRSN SENNEFFE (60 cps) serial printer DDR address 

KEBRSN KEYBOARD DDR address 

SCREENSN SELF SCAN(SS1 or S52) and CRT DBR code slice address 
ADCRSN ASYNC DATA COMM DDR code stice address 

SBURSN SYNC BATA COMM DDR code slice address 

DCSLICE DATA COMM COMMUNICATE handling code slice address 
CONSN CONSOLE COMMUNICATE handling code slice address 
PANRSN PANTIN (120 and 180cps) serial printer BDR address 
INXSN INDEXED FILE COMMUNICATE handling code stice address 
2 RTERSN REAL TIME CLOCK DBR code slice address 

2 ICMSRSN ICMD DDR code slice address 

2  MESSSN BATA COMM MESSAGE BUFFER SPACE slice address 

2 CONBUFSN CONSOLE FILE BUFFER (non SCL keyboard input) address 
@ SCLBUFSN SCL (keyboard and ZIP) BUFFER slice address 
2 

2 

2 


www www ww mw fn 


J 


DIAGSN TRACE DIAGNOSTICS MCP code stice address 
OCOM.SN © OVERLAYABLE COMMUNICATE handling code siice address 
0 FREESN two-byte address stots used as required for 
Program Control Block (PCB) program code stice addresses and 
Interpreter Control Block (ICB) interpreter addresses . 
slices 39-48 : 
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SATM MAP - SLICE ADDRESS TABLE 
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TABLE 6.3.1 RS MAP (3.01) - SLICE DESCRIPTOR 


OFF LEN 

SET GTH FIELD 
0 §D 

0 SDFL{:a 
1 SDUSRS 
4 SDPEO 


SBADDR 
SDCFDI 
SDIEO 


SDLENG 
SDDKAD 
SDTKSC 
SDUNIT 
SDSEGSZ 
SDPLNK 
SDSLESZ 


Slice Descriptor FLAGs 

stice USER count (applies to Code Control Blacks) 
Program Environment Offset (applies only to TC8s> 

index in SAT of stice address of PCB of this task’s PCB 
mesory address of segment 

applies only to single segment DDR slices 

Code File Directory Index (applies only to CCBs) 

index in the disk directory of the disk copy 
Interpreter Environment Offset (appties to TUBs) 

index in SAT of the associated Interpreter stice address 
LENGth (in bytes? of the disk copy of this stice 

Disk ADdress (TracK and SeCtor) of the disk copy 


disk UNIT on which the disk copy resides 


Pink LiNK - memory address of the next slice 


RS MAP (3.01) - SLICE DESCRIPTOR 


FORMAT 


LABEL 
TABLE 4.3.2 
NOTE 1 
INDEX 


AA BR 


INDEX 


INDEX 


B BR 
B BR 


TABLE 7.2.1 
LABEL 

AA BR 

NOTE 2 


TABLE 6.3.1 29 MAP (3.01) - SLICE DESCRIPTOR (cont.-) 


10 2  CCBCSTB (CCB) address of Code Segment Table Base AA GR 

10 2 PEP (108) address of related PCB slice descriptor AA BR 

te 2 CCBESTL (CCB) address of Code Segment Table Limit AA BR 

je 2 IEP (TB) address of related ICB slice descriptor AA BR 

14 - = (CCBRAE (CCB) start of Preset Area 2 NOTE 2 

14 2 DSTA Data Segment TAble address AA BR 

14 2 DSTLIM BST LIMit address AA BR 

wo CSBS Control Stack BaSe address AA BR 

18 2 COPA Control Stack Pointer Address fA BR 

2 2 CSLM Control Stack LiMit address AA BR 

ee i OID task-id of the originator of this task TABLE 7.4.2 
a3 2  SNTHSK MASK for field SINTFLAG of map INTERGLBL TABLE 7.1.1 
a 3 FCH Fetch Communicate Message as returned from the MCP TABLE 8.4.2 


NOTE 1 If bit 4 (810@) of SDUSRS is set then 
the slice may not be swapped out. 


NDTE 2 If a slice is swapped out only the first 10 bytes 
of the-descriptor remain in menory 


NDTE 3 non MCP CCB stice descriptors 
are 14 bytes long (up ta CCBPA2) 


WE slice descriptors are 33 bytes long 
and extend into an 5 Interpreter Work Area (SIWA} 


RS MAP (3.01) - SLICE DESCRIPTOR (cont. ) 
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TABLE 6.d.€ SLICE DESRIF TOR FLAGS - FIELD SDFLAG GF HAP RS 
BITS MASK INTERPRETATION 


reserved 

SLICE STATUS 

reserved 

SLICE TYPE 

MEMORY PAGE NUMBER for all segments associated with this slice 
last entry in PINK LINK chain 


“ 
mn 


Sm fb es OW NI 
rm 


SLICE STATUS: 
VALUE INTERPRETATION 


40 ABSENT from memory (SWAPPED OUT? 
20 so MAINTAINED and PRESENT in aemory 
GO ABSENT 


SLICE TYPE: 


VALUE INTERPRETATION 

Task Control Block (108) 

Code Control Block (COB); DDR, FDR, PCB, or IC8 
GO ~—s single segment stice 


TYPICAL SDFLAG VALUES: 


absent single segment slice 

Maintained single segment slice 
maintained CCB with segments in page 0 
maintained CCB with segments in page 1 
aaintained TCB 

swapped out CCB 

swapped out TCS 

last entry in PINK LINK chain 


SSEFHRRRBS 


SLICE DESCRIPTOR FLAGS - FIELD SDFLAG OF MAP RS 
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TABLE 6.4.1 - SEGD MAP - SEGMENT DESCRIPTOR 


OFF LEN 
SET GTH FIELD 


USE 


GO 1 SGDFL Sebment Descriptor FLags 

1 2 S6Dss Segment Start address in memory 

3 2 S6BSL number of bytes in the segment 

3 2 SGDDA Bisk Address (zero relative sector) of the disk copy 
7 1 SGDDU Disk Unit holding the disk copy 

8 - SZ.SEG.DESC - 


TABLE 6.4.2 ~ SEGMENT DESCRIPTOR FLAGS - FIELD SGDFL OF MAP SEGD 


BITS HASK INTERPRETATION 


80 1 = segment USED recently 

40 1 = segment ABSENT from memory (overlayed) 

2001 = segment OVERLAYABLE (not iocked) 
reserved 

08 1 = segment may be updated (READ-WRITE) 


4 i= 


segment is not for system use 


02 reserved 


OM MAE OO NI | 
~ 
iow] 


ol is 


TYPICAL VALUES 


segment has been updated since it was read into memory 


FOR MOST SIGNIFICANT DIGIT: 


Ay 2 OVERLAYABLE segment PRESENT in memory 
8, 0 LOCKED segment (will be located in slice} 
& & ABSENT (overlayed) segment 


TYPICAL VALUES 


Dy % segment 
C,8,4 segnent 


FOR LEAST SIGNIFICANT DIGIT: 


UPDATED 
NOT UPDATED 


SEGD MAP - SEGMENT DESCRIPTOR and 


SEGMENT DESCRIPTOR FLAGS - FIELD SGDFL OF MAP SEGD 
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FORMAT 
TABLE 6.4.2 
AA BR 

& BR 

B GR 

TABLE 7.2.1 
LABEL 
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SECTION 7 


ds GLOBAL MCP MAPS AND TABLES 
2 BeBe: 
This section discusses the information held in the Global MCP 
maps and tables. These maps should be examined in detail if the 
preliminary analysis discussed in section four is insufficient. 
On each release of the MCP, these tables are located at a specific 
address in memory. As the offset and format of each map may change 
between release levels, PMB80 handles this by having different 
reference files PMBM.nnnnn and PMBO.nnnnn (see section 3). 
The global maps are analysed by PMB80 using the PRINT GLOBAL option. 
Single maps may be selected for printing by the appropriate parameter 
to the print command (GWA, DIAGNOSTICS, VMWA, ESCT or SCL). 
7.1 MCP - INTERPRETER INTERFACE 
The interpreter global work area (Table 7.1.1) holds the memory 
addresses of various global MCP routines. It also holds the 
first link into the memory organisation through SATLINK. A 
check should be made that these fields hold valid values. 
For example, the Global MCP routines lie below the locked slice 
area between @1000@ and @4000@, so the addresses of the global 
routines should be in this range 
Another interesting field is TOTSICT. This is used in thrashing 
detection which is discussed in section 7.5.3. 
ded PERIPHERAL INTERRUPT HANDLING 
The peripheral handling dump area (PHDMP MAP Table 7.2.1) 
is used when the MCP is handling hardware interrupts, and 
when printing trace diagnostics. 
When a hard interrupt is received from an I-0O channel, the ROM 
code causes entry to the Master Interrupt Processor (MIP). 
This global MCP code stores the contents of the processor 
registers in PHDMP, and performs basic interrupt handling. 
2015400 


7. 
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bale 


7.3 


7.4 


GLOBAL MCP MAPS AND TABLES (CONT.) 


PERIPHERAL INTERRUPT HANDLING (CONT.) 


If the General Trace (GT) facility is switched on 

(see section 5) the processor registers are stored 

in PHDMP each time a trace point is encountered. If 
the system fails and issues a diagnostic on PK-lights 
17-24 (see section 5) the processor registers are also 
stored in PHDMP. 


Thus, the register dump fields of PHDMP contain the contents 
of the processor registers, either at the last I-O interrupt 
or the last diagnostic trace point. The latter case can 

be distinguished since PHDMPAD will equal the last one byte 
diagnostic in DIAGCIRC (Table 7.4.1). 


In either case, the contents of these dump areas usually give 
the most accurate information on which function the MCP was 
performing before the dump was taken. The interpretation of 
the registers is explained in section 5.1. 


The remaining fields of PHDMP are used by the MIP in 
handling I-O interrupts. Ihe field INTMASK gives the I-O 
channels on which interrupts may be processed. The field 
INT.SCAN.TABLE provides the order in which interrupts should 
be processed. The field ISCT gives the channel which was 
last serviced; this field points to the PHT associated with 
that channel. 


KEYBOARD VERSION AND SPO TYPE 


The VERSIONINFO MAP (Table 7.3.1) indicates which translation 
table the MCP is using for printing characters. 

If wrong characters are being printed (£44, $, etc.) this 

field should be checked and an engineer should be asked to 

give advice about correct installation of the machine backplane. 


DIAGNOSTIC INFORMATION 


As its name suggests, the DIAGCBUF MAP (Table 7.4.1) 

holds information specifically aimed at assisting problem 
diagnosis. It consists of three parts. The circular 
buffer of one byte diagnostics (DIAGCIRC) indicates what 
the MCP has been doing; that is, which of its global and 
slice code has been running. The register save areas give 
the task which is running and which microcode this task 

is using. 


The light switch indicates whether the keyboard was enabled 
at the time that the dump was taken. 


The PRINT DIAGNOSTICS option of PMB80 causes this map to 
be printed. 


7. GLOBAL MCP MAPS AND TABLES (CONT.) 
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2015400 


DIAGNOSTIC INFORMATION (CONT.) 


7.4.1 


7.4.2 


ONE BYTE DIAGNOSTICS 


Trace diagnostics are discussed in section 5. Each 
time a trace point is encountered, the one-byte trace 
diagnostic is inserted in DIAGCBUF. This is done 
whether or not the MCP trace function has been switched 
on using the GT command. 


Field DIAGNINDEX of DIAGCBUF is the byte offset (zero 
relative) of the position of the next entry to be made 

in DIAGCIRC. With the entries in DIAGCIRC and reference 
to tables 5.3.1 to 5.3.11, it is usually possible to 
determine what the MCP was doing immediatcly before 

the dump was taken. 

No entries are made in DIAGCIRC when peripheral interrupts 
occur. This should always be remembered, and reference 
made to the PHDMP map to determine when the last interrupt 
occurred (see section 7.2) 


TOP OF CONTROL STACK 


The switching of control between tasks is performed 
by the EPAR (section 7.6.1). ‘When EPAR exits and 

control is passed to a task, a diagnostic with value 
@EE@ is entered in DIAGCIRC and the registers XY, L 


Aro mi. 
and J are saved in XYSAVE, LSAVE and JSAVE. The 


contents of these registers at this time indicates 
which task gained control and which microcode was 
entered from EPAR,. 


XYSAVE holds a copy of the top four bytes of the control 
stack of the task which was entered, (see table 7.4.2), 
and indicates in which microcode segment and at what 
offset the entry occurred. LSAVE holds the memory 
address (byte reversed) of the task slice descriptor. 
JSAVE holds the memory address (byte reversed) of the 
microcode segment to be executed. 


Only microcode may execute on the B80 processor; 
therefore all tasks except microcoded tasks need an 
interpreter to be executed. Even microcoded tasks 
make heavy use of the MCP routines for peripheral and 
file handling. Thus it is very rare to find the entry 
code in XYSAVE referring to a task slice. The entry 
code usually refers to one of the following (refer 

to Table 7.4.2): 
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GLORAT, MCP MAPS AND TABLES (CONT.) 


DIAGNOSTIC INFORMATION (CONT.) 


7.4.2 TOP OF CONTROL STACK (CONT.) 


INTERPRETER : It is very unusual for problems 
to be encountered in an interpreter. 
The problem is likely to be related 
to a hardware interrupt. 


DDR : Many program communicates require 
input-output operations. These will 
be performed by an MCP DDR slice. 


MCP FUNCTION : Some program communicates require the 
execution of a Function Dependent 
Routine of the MCP. For example, 
file open and close, index file commu- 
nicates, console file communicates. 


ABSOLUTE ADDRESS : Global MCP routines are entered at an 
absolute address. These addresses are 
stored in the INTERGLBL map (see table 
7.1.1, and section 7.1). 


LIFF (slice 0) - a microcoded MCP task, see Section7.6.3 
SCL/LOADER (slice 15) - a microcoded MCP task, see Section 7.7. 


NOTE: 


Slice numbers in XYSAVE are twice the value expected. 

They provide an index into SAT which has entries two bytes 
long. For example, if XYSAVE has a value @12220000@, then 
the last code entered was slice 17 (=@22@/2), segment 18 


offset O, a segment of the MCP OPEN-CLOSE slice. 


VIRTUAL MEMORY SUBSYSTEM 


All movement of segments in and out of memory is the ‘responsibility 
of the Virtual Memory (VM) subsystem. The VMWA (Table 7.5.1) 
is its work area. 


The work area contains memory addresses, lengths, an 
I-O descriptor for loading and unloading segments, and 
a "GETSEG" counter. 
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VIRTUAL MEMORY SUBSYSTEM (CONT.) 


7.5.1 


7.5.2 


7.5.3 


MEMORY LINKS 


Withcut refernce to the MCP listing it is difficult 
to be certain of errors in the VM pointers. If a 
virtual memory operation is in process, the pointers 
may be in a transient state and be marked on the dump 
as "illegal". (The PRINT MEMORY.LINKS option of PMB80 
may produce spurious errors on such a occasion). 


If a memory link becomes overwritten by some other 
part of the MCP, then the system may continue to run 
satisfactorily until the VM subsystem encounters the 
corruption. For this reason it is possible for the 

VM routine to fail due to a fault in another part of 
the system. A dump showing a fault in the memory 

links may not give the solution to a problem but rather 
the symptoms of a completely independent fault. 


VIRTUAL MEMORY I-O 


The virtual memory I-O has the standard I-O descriptor 
format (see table 9.3.3). The most important field is 
the flags IODFL. 


Since, in a virtual memory system, disk is an extension 
of main memory, a disk "parity error" has very. serious 
implications. If the B80 MCP is unable to access any 
of its virtual memory on disk, then execution is halted 
and a "DF" diagnostic is displayed. The virtual memory 
I-O descriptor contains further information about the 
failure. The flags define the nature of the error (see 
table 9.3.4), the disk unit and address fields locate 
the area of failure. 


THRASHING DETECTION 


The virtual memory subsystem is responsible for 

thrashing detection. It uses the field GETCNTR, and the 
field TOTSICT of map INTERGLBL (table 7.1.1). 

GETCNTR is set to @100@ and decremented by one each time a 
segment is read from disk into memory. At the same time, 
TOTSICT is set to zero and incremented by one for each 
S-OP processed by an interpreter. GETCNTR provides a 
measure of the "wasted" work and TOTSICT measures the 
"useful" work. If the ratio (256-GETCNTR): TOTSICT 
becomes greater than 1:100, then the MCP takes action 

to reduce thrashing. As the fields are periodically reset, 
no useful information can be derived if GETCNTR is close 
to @100@ and TOTSICT is close to 0. 


7. GLOBAL MCP MAPS AND TABLES (CONT.) 
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SYSTEM CONTROL 


The MCP has three resources to manage; the processor, the 

MCP routines used by tasks, and the memory. The processor and 
MCP functions are allocated by the Execution Priority Assignment 
Routine (EPAR), the task control subsection. The memory is 
allocated by the Bailiff,task O. 


The global MCP map GLBLM (Table 7.6.1) is the work area used 
by these sections of the MCP to control the allocation of these 
resources. The PRINT GLBLM option of PMB80 prints the contents 
of this map. The PRINT MIX option provides an analysis of some 
of the more useful fields of this map. 


7.6.1 


PROCESSOR ALLOCATION - EPAR 


The EPAR manages the control of the processor by a 

system of "independent runners". These independent runners 
are tasks, each having a task-id and a corresponding 

mix number between O and 15 (see table 7.6.2). 


ime, only one of these tasks is the current 
task and has control of the processor. 


Each task has an entry in the Execution Scan Table 
(ESCT). The field EICT of map GLBLM points to the 
entry in ESCT for the CURRENT task. This byte, also 
called the task-id is displayed on the keyboard 
D-lights when control is passed te the task. 


Section 7.4.2 describes how to determine the function 
that the task is currently performing. 


The status of all the tasks in the system is stored 

in the Wait Key Table (WAKT). Each entry in the ESCT 

has a one byte entry in the WAKT in the corresponding 
position. The order in which the task-ids occur in the 
ESCT and WAKT reflects the relative priorities of the tasks. 


The highest priority tasks occur first. The first six 
tasks in the table have specific functions and always occur 
first, followed by "user" tasks. 


The value of the entry in the WAKT indicates whether the 
task is runnable or waiting, plus the cause of waiting 
if applicable (see Table 7.6.3). 
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SYSTEM CONTROL (CONT.) 


7.6 


7.6. 


22 


3 


MCP FUNCTION CONTROL - LOCKS 


Some MCP routines may not be used by two tasks simultaneously. 
Each of these routines has a lock. These locks reside in 

the GLBLM map (table 7.6.1). If a task is using one of these 
routines (for example: opening a file, or displaying a message 
on the SPO) then the lock corresponding to that routine is 

set to the task-id. Such a lock and its corresponding 

MCP routine may not then be used by another task, which will 
have to wait. 


There may exist problems with the use of locks 

which could cause either a program or the complete 
system to hang. If there are two tasks holding 
different locks, and both of them are waiting for 
the lock which the other task holds, then a deadlock 
situation arises. Neither task can proceed. 


MEMORY ALLOCATION - BAILIFF 


The Bailiff (task 0) controls the allocation of memory 
to tasks. If there is sufficient memory for all tasks 
in the mix, then the virtual memory subsystem will 

be overlaying segments in the overlayable area as 
required. If however, there is a shortage of memory, 
then thrashing will be detected and the Bailiff will 
come into operation. 


The Bailiff swaps slices in and out of memory. Swapping 
should not be confused with the segment overlaying operation 
performed by the virtual memory subsystem. Swapping is 

an operation performed on a locked slice. When a slice 

is swapped out, the entire locked slice (excluding the 

first ten bytes of the slice descriptor) is written out 

to disk and the other contents of the locked slice area 

are moved down in memory. In this way, more overlayable 
memory becomes available. 


Slices may volunteer for eviction by having no users, 
or being long waited, or they may be conscripted as 
required. 


Volunteers will only be swapped out when either enough 
volunteers exist to make it worthwhile (field SWAPCNT 
of map GLBLM is small enough), or thrashing has been 
detected. If thrashing is detected and no volunteers 
exist, then a slice (usually a TCB) will be conscripted. 
If a task (TCB) is swapped out then it is no longer 
runnable. The task will be restored when more memory 
becomes available. 
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GLOBAL MCP MAPS AND TABLES (CONT. ) 


SYSTEM CONTROL (CONT.) 


7.6.3 MEMORY ALLOCATION ~- BAILIFF (CONT. ) 


If a program is written which has very large segments 
(either data or code) then it is possible for thrashing 
to be detected when this is the only program running. 


In this case, the task will be evicted and never restored 
since no more memory becomes available. The operator 
must intervene with a GO command. 


The work areas used by the Bailiff to make decisions 
on swapping can be found in the GLBLM map (table 7.6.1) 
with further explanation in table 7.6.4. 


SCL INTERPRETER AND LOADER 


Task number 15 is reserved for the MCP slice which interprets 
the System Control Language (SCL) commands, and loads programs. 
When this task is running, the D-lights D4, D5, Dé, D7 will all 
be on. 


The SCLBUFFER map (Table 7.7.1) holds the last SCL input (either 
from the keyboard or from a ZIP) and is terminated by GIiF@. 


TABLE 7.1.1 - INTERGLBL HAP (3.02) - INTERPRETER WORK AREA 


OFF LEN 
SET GTH FIELD USE FORMAT 


——— awe ——— ee 


O 3  GOSCANMIX memory address of global MCP routine AA BR 
3 3. GOFINDCOD . : 

& 2  SATLINK pointer to the Stice Address Table (SAT) fA BR 
8 § TOTSICT total count of S-Instructions executed since B BR 


field GETNTR of map YVMWA was fast initialised - 
used for THRASHING detection 


te 2 KDUMP duap of the K register = 

14 2 SINTFLAG S-INTerpreter flag, the interpreter will . 
release control and the HEP will SCANMIX - 
when it is non-zero - 

14 2 SIfOUNT S-Intruction count since branch ta interpreter B OER 

18 1% GOMCH 60 to Master Communicate Handler (HCH) 7 
when non-zero - 

19 2 TAMCH aeaory address of giobal HCP routine AA &R 

fi 3 = GOYIELD " . 

&% 3  GOGETSEG u 7 

27 3 = GOPUTSEG “ . 

3 4 ~ = BATEJ dutian day (first three characters) ASCII 

% 2 DATEY Year ASCII 

% 2 BATEM Month ASCII 

38 2 ~~=«=DATED Day ASCII 

40 3 DAYOW DAY Of the Week - 

43 1 GQODTIME TIME inforaation - 

4 3 TIME : - 

47 10 MIDNITE * - 

37 1 sRTCEXIST non-zero if Real Time Clock EXISTs - 


INTERGLBL MAP (3.01; - INTERPRETER WORK AREA (cont. ) 
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TABLE 7.4.1 - INTERGLBL MAP (3.01) - INTERPRETER WORK AREA (cont.) 


3 


& 
2” 
7 
74 
7? 
81 
% 
87 
at] 
A) 
96 
cad 


6 


WIN WI ot OI ww OW fm Ww OI GI oO 


VERSION gark, release, and patch level 


of last MCP compitation (PHBBO files use this id) 


ACTUAL.VERSION version of this patched HCP 
GOUNWTONE aeaory address of global HCP routine 


GOYIELDR 2 
GOPUTSLCR 
GOGETSLE 

GOUNWTL 

GOSTK.d 

GOUNSTK.d 
GOMSPRINTSTKR 
GOMSPRINTSTACK 
GOMSPRINTR 
GOMSPRINT 


INTERGLBL MAP 


(3.01) 


- INTERPRETER WORK AREA 


2s sastresest 


TABLE 7.2.1 - PHDMP MAP (3.01) - PERIPHERAL HANDLING DUMP AREA 


2015400 


OFF LEN 

SET GTH FIELD 

OG 1. PHBMPRQ 

1 2 PHDMPEX 

3 8  PHBMPST 
"8 PHEMPXY 

11 i PHDMPAD 

12 1 PHDMPE&C 
13°12 ~~) -PHDMPBF 

w PHDMPFL 

144 2 PHBMPBI 

15 2 PHDMPB32 
17 2 = PHDMPY 

19 2  PHDMPK 

2i 2) PHBMPL 

23 2  PHDMPMI 
2 2  PHBMPWR 
2? 2 PHDDRRESETU 
"4 PHDDRDMPHI 
Si 2 = PHBBRREENT 
cont..... / 


PHDMP MAP (3.01) 


1-0 channel last serviced 

EXit address store 

top of control STack, held in 
XY processor register dump area 
AD uw 

BG u 

reaap of 

FL processor register dump area 


WR u 

d duap area for DDR use 
Hi " 

DDR RE-ENTry address 


~ PERIPHERAL HANDLING DUMP AREA 


FORMAT 
TABLE 9.2.2 
tA BR 
TABLE 7.4.2 
TABLE 3.1.1 


% 


AA BR 


TABLE 7.2.1 - PHDMP MAP (3.01) - PERIPHERAL HANDLING DUMP AREA 


SSEtk GRAGARA 


|aasg a 


a a ee ed 


COS te 


om Mm CO CO 


QTe 

QTs 

QPRODE 
QPRODG 
1OX.SOFT REQ 
SOFT REQUEST 
SOFT. INT MASK 


SOFT.REQ.CH 
INT MASK. DUMP 
INT .WASK.VH 
INT.MASK.DC 
INTHASK 
INT.MASK 


INT. SCAN, TABLE 


DISK.UNIT TABLE 
PHT. ADDR. TABLE 


ISCT 
DISK.RAW.FLAG 


NOTE 1 


NOTE 2 


PHDMP MAP (.301) - PERIPHERAL HANDLING DUMP AREA (cont.) 
pee adc tc De aa 


(cont. ) 


Current Queue polled 
first Queue polled 
Q-Poll exit on failure (address and offset) 
Q-Poil exit on success (address and offset) 
channel expander soft interrupt flag 
bit set indicates soft request to enter DDR 
bit set indicates soft interrupt 
by de-selected device 
channel address of soft request 
INTerrupt MASK DUMP area (data coma) 
INTerrupt MASK excluding mixed channe! expander 
INTerrupt MASK tncluding mixed channel expander 
bit set indicates atiow interrupt 
renap of above 
channel adresses 
in descending order of priority 
disk unit numbers in the above order 
PHT addresses in the above order 
set to address of current PHT on interrupt 
Read After Write flag 


an I-0 queue head is six bytes long, and so 
valid queue "numbers" are @00@ @046@ @0C@ etc. 


Non disk channels have value @FF@. 
Each disk channel accomodates 2 units, and so 
these unit numbers are @00@ @028 etc. 


NOTE 1 


AA BR,RA BR 
8 
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TABLE 7.2.2 - DEVICE MNEHONICS IN DESCENDING ORDER OF PRIORITY 


CODE BEVICE 

SPC sync data coma 

ADC async data coma 

cassette 

cartridge disk 

201-1 fixed disk 
Burroughs super mini disk 
industry compatible mini disk 
tine printer 

serial printer 

keyboard 

self scan 

real time clock 


CT 
DK 
IF 
IM 
DI 
LP 
SP 
kB 
SS 
RT 


DEVICE MNEMONICS IN DESCENDING ORDER OF PRIORITY 
ee ea EEE 


TABLE 7.4.1 - VERSIONINEO MAP (3.04) - KEYBOARD AND SPQ INFO 


OFF LEN 
FORMAT 


KBVERSION KeyBoard VERSION (i= G=UK J=FRANCE etc.) BINARY 
VERSTONFLAG 0 for 44-character set, 2 for %4-character set - 
DISP.LINE.LENGTH display line tength B BR 
DISP.PAGE.HEIGHT display page height (0 for printer) BINARY 
DISP.DVCK display device kind TABLE 6.5.2 
DISP.PHT memory address of DISPlay PHT AA BR 
DISP.QHDO DISPlay Queue HeaD Offset INDEX 
DISP.DDR.SN DISPlay DDR Slice Number (index ia SAT? INDEX 
MSEXIT message printer routine exit inforaabion . 


OCW UL MS 


oS 
oe eee TD 


VERSIONINFO MAP (3.01) ~- KEYBOARD AND SPO INFO 
VERSIONING MAR \oeMi Oe 


TABLE 7.4.1 - DIAGCBUF MAP (3.01) - GLOBAL DIAGNOSTIC INFO 


OFF LEN 
SET 6TH FIELD FORMAT 


O 1  DIAGINDEX index of next one byte entry in DIAGCIRC INBEX 
1 32) DIAGCIRE circular buffer of one-byte BIAGNUSTICS TABLE 3.2.5 
33 - ~—ODIAGCEND = LABEL 
RS! XYSAVE top of control stack on exit from EPAR TABLE 7.4.2 
JSAVE pointer to base of SLICE or CODE SEGMENT AA BR 
LSAVE pointer to base of Task Control Block (TCB) aa BR 
LIGHTSW Q@FF@ indicates that the console lights = 
are available for diagnostic information o 
i.e. the keyboard is not enabled - 


TABLE 7.4.2 - TOP FOUR BYTES OF CONTROL STACK (RESTART ADDRESS} 


ENTRY CODE SLICE or SEGMENT OFFSET RESULTING ERANCH 
ONE BYTE TWO BYTES REVERSED 


SEGMENT NUMBER SEGHENT OFFSET TO INTERPRETER SEGHENT 
(>B20@) INDEX IN SAT = SEGMENT OFFSET TQ SINGLE SEGMENT SLICE 
(=@208) ABSOLUTE ADDRESS TO GLOEAL MCP CODE 
(>@20@) INDEX IN SAT = SEGMENT OFFSET TO HCP SLICE SEGHENT 
(@1E@-@02@) TCB INDEX SEGHENT OFFSET TO TASK SEGMENT 

NUMBER (=@00@) BAILIFF SEGNENT OFFSET TO BAILIFF SEGMENT 


DIAGCBUF MAP (3.01) - GLOBAL DIAGNOSTIC INFO and 
ae ee 
TOP FOUR BYTES OF CONTROL STACK (RESTART ADDRESS) 
the NN a 
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TABLE 7.5.1 - VAWA MAP (3.01) - VIRTUAL MEMORY WORK AREA 


OFF LEN 

SET GTH FIELD 
oO 4 - 

4 2 VMSTK 
& 2 VMVSD 
8 2  VHVLN 
10 2 VMSCN 
2 2 VMLIM 
144 2 VHLNK 
16 2  VMRSD 
i8 2 VHRLN 
2 18 VMIOD 
3B 2 PTRX 
40 2 PTRY 
42 2  PTRZ 
44 2  PTRA 
46 2 GETCNTR 


USE 

pseudo contro! stack for virtual aemory restart 
CSPA from current task SIWA 

address of Victim Segment Descriptor 

Victia segment LeNgth 

tlear memory SCaN potnter 

clear memory scan LIMit 

memory LINK of first victia segment 

address of Requesting Segment Descriptor 

first two bytes of I-O descriptor 

equals Requesting segment Leflgth 

Virtual Memory I-O0 Descriptor (see HAP IOBESC) 
start of OVERLAY ARENA 

virtual memory work pointer 

end of overtay arena (5 bytes past last segment) 


count of GETSEG operations 


VMWA MAP (3.01) - VIRTUAL MEMORY WORK AREA 


FORHAT 


B ER 
TABLE 9.3.3 
AA BR 
AA BR 
AA BR 


B BR 


TABLE 7.4.1 - GLBLM HAP (3.01) - EPAR AND BAILIFF GLOBALS 


OFF LEW 
SET GTH FIELD USE 
O© 2 EICT address of current ESCT entry 
2 -  ESCT Execution SCan Table 
task-ids in descending order of priority 
2 1 BLFESC? BaiLiFf ESCT entry (#ix=0) 
3 4 AVRESCT Automatic Volume Recognition task (mix=%) 
4 1%  LDRESCT LOABER-SCL task (mix=15) 
> 1 NDLESCT NBL ESCT (mix=i4) 
& 1  MCSESCT MCS task (mix=19) 
7 1 SUESET Super-Ubiltity task (mix=i12) 
8 41 FIRSTBC the rest starting with B-priority tasks 
19 - WAKT WAit Key Table in the same order as the ESCT 
12, 10 BLFWAKT Bailiff WAiE Key 
20 15 AVRHAKT AVR WAIL Key followed by the rest 
3 i VMLOCK Virtual Memory LOCK 
4 i OCLOck Open-Close routine LOCK 
37 4 = (OCLOCKe Gpen-Close LOCK 2 
38 i SLCLOCK SLiCe routine (loading and swapping) LOCK 
3? 10 MSLOCK NeSsage printer (SPO) LOCK 
40 12 LDRFLAG LoaDeR-SCL FLAG, set by ZIP or keyboard input 
to the task-id 
41 1° LDRLOOSE - 
42 1  DSPFLG DiSPlay FlaG (@FF@=display to be done) 
43 1  HLPFLO HeLP routine FLaG (@FFG=DDR swapped out) 
44 1° HLPFLG.AVR @FF@ indicates run the AVR-OPEN-CLOSE help routine 
45 1 BADIC.LOCK BAlLiff Descriptor I0 information 
46 1 BADIO.FLAGS used by the logging routine 
47 2  BADIG.LNTH a 
49 2  BADIG.ADDR e 
Si 1 BADIO.UNIT " 
Sse 20) «BADIO. DESC : 
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GLBLM MAP (3.01) - EPAR AND BAILIFF GLOBALS 


FORMAT 


AA BR 


TALE 7.6.2 


ABLE 7.4.3 


OTE 1 


zs spe neaeses a2 ww BF A 


TABLE 7.4.2 


76 


| SSSRBRRRARRSYAN 


PN eS a be ol ool noel coe eel oll oll dll aoe 


TABLE 7.4.1 - GLBLM HAP (3.01) - EPAR AND BAILIFF GLUBALS 


VOL.ID 
VOL 
EREADY 
EVICT 
BFLAG 
BIOMAT 
SWAPIN 
SHAPOUT 
SWAPCNT 
EVICTID 
CONSCRIPT 
RSTID 
LOGFILEFIN 
ERRLOGOFF 
HBESCT 
SCLINIT 
XTNFLG 
XTNSIZE 
SUHIDE 


NOTE 1 


(cont. ) 


task-id of sofe volunteer (@FF@=not ane) 
VOLunteer bailiff flags 

there Exist READY-to-restore tasks 
EVICT flags . 
Bailiff flags ; 
Bailiff I0 MATured flag (O=nat) ‘ 
task needs SWAPping IN (O=nat) - 
task ready to SWAP OUT exists (Q=not) 
-(number of stices with zero users +1) 
ID of task selected for EVICTION 

id of task conscripted 

ID of task selected for ReSTore (swap ia) . 
LOG FILE FINished flag (O=not) - 
Q@FF@ = fogging nat yet switched on (at warmstart) - 


“TRARY 
TABLE 7.4.2 


address of first class B task ESCT entry AA BR 
valid date entered (not=@FF)(warastart only? = 
eXTeNded aemory FLab (@FF@=none) = 
eXTeNded aemory size (@0000@=44KB) B BR 


Lock bytes equal @00@ when they are free, 
oc equal the ESCT (task-id) byte 
of the task holding thea 


GLBLM MAP (3.01) - EPAR AND BAILIFF GLOBALS (cont. ) 


TABLE 7.6.2 - TASK-ID, TASK STATUS, MIX NUMBERS 


FIELD ESCT OF MAP GLBLM: 


774 CO TASK STATUS 

3 20 PRIORITY FLAG (O=promoted priority) 

4-1 1E MIX NUMBER (shifted left one bit} 

@ 01 EXCHANGEABLE FLAG (i=exchangeable with adjacent tasks in ESCT} 


TASK STATUS (logical AND of TASK-ID with @OC@): 


VALUE INTERPRETATION 
8 LONG WAITED 
40 

00 —-RUNNABLE 


MIX NUMBERS (logical AND of TASK-ID with @1E@): 


CO = MIX = 0, BAILIFF 

02-10 MIX = 1 to B, USER TASKS 

12. HIX = 9, Automatic Volume Recognition (AVR) 

14-16 MIX = 10 and 11, UTILITIES 

18 = MIX = 12, SYS-SUPERUTL 

YA —sOUMIX = 13, Message Control System (MCS) 

100 MIX = i4, NDL 

iE = MIX = 15, program LOADER and System Control Language (SCL) code 
Logical AND of field WAKT of map GLELM with @1F@: 


TASK-ID, TASK STATUS, MIX NUMBERS 
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TABLE 7.6.3 - WAIT KEY TABLE (WAKT) VALUES (Logical AND with G1F@) 


RUNNABLE (i.e. not waiting) 


FREE (corresponding ESCT task is not assigned) 
NDL waiting 


MCS waiting on MCSQUEUE 


waiting on AD command from the operator 
waiting on NO DISK FILE 

waiting on FILE IN USE 

waiting on NO FILE 

waiting on DUPLICATE FILE 

waiting on NO USER DISK 

Waiting on OPERATOR INPUT 

waiting on DEVICE NOT READY 


SYS-SUPERUTIL waiting on SUPER ACCEPT 

waiting on RESTORE by bailif 

Waiting on DISPLAY 

waiting on ECHO 

waiting on HESSAGE PRINTER (SPO) (field MSLOCK of map GLBLM) 
waiting on ZIP 

waiting on ACCEPT 

HALF DELAYED 

waiting on SLICE routine 1-0 (field SLELOCK of aap GLBLM) 
waiting on PROGRAM LOADER (field LDRFLAG of map GLBLM} 
waiting on VIRTUAL MEMORY I-O (field YHLOCK of map GLBLM) 
waiting on file OPEN or CLOSE (field OCLOCK of map GLBLN) 
waiting on SECONDARY file OPEN or CLOSE (fietd OCLOCK2 of aap GLBLH? 


OF 
0€ 
oD 
0c 
08 
A 
td 
08 
07 
06 
0S 
% 
0g 
ce 
OL 
00 


WAIT KEY TABLE (WAKT) VALUES 
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TABLE 7.4.4 VOL, EREADY, EVICT, BFLAG 


BAILIF FLAGS HELD IN MAP GLBLM: 


VOL (are there any tasks VOLUNTEERING for EVICTION ?): 


BITS MASK INTERPRETATION 


OT ee Oe eel ee a ee me ee oe 


7 80 VOLUNTEER NEWLY CREATED 
& 40 VOLUNTEER EXISTS 
36 SF always set 


VALUE INTERPRETATION 


F NO VOLUNTEER to be swapped out exists 
*F A VOLUNTEER exists 
FF A NEW VOLUNTEER exists 


EREADY (are there any tasks READY to be RESTORED 2): 


BITS HASK INTERPRETATION 


mn Me GELS eR ee eR ee ee 


7 80 there exists ore than one task READY TO RESTORE 


& 40 there EXISTS ONE task READY TO RESTORE 
+O JF always set 


VALUE INTERPRETATION 


Oe ee ee eee 


there exists NO TASK which would be runnable if restored 


Fr 
Fr there exists ONE TASK ° 
FF there exists MORE THAN ONE TASK 


cont...../ 


VOL, EREADY, EVICT, BFLAG 
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TABLE 7.6.4 VOL, EREADY, EVICT, BFLAG cont.) 


EVICT (what shall we EVICT 2): 


EVICT CONSCRIPTS 
EVICT VOLUNTEERS 
FORCE EVICT 
always set 


BFLAG (what is the BAILIFF doing now ?}: 


BITS MASK INTERPRETATION 


there MAY 8E ROOM to RESTORE a task 
EVICT DONE 
ANOTHER EVICT is NOT NEEDED 


there is an EVICT IN PROGRESS 
there is a RESTORE IN PROGRESS 
the TASK BEING RESTORED is FROM the READY QUEUE 


7 
4 
5 
4 
3 
2 
i 
G 


VOL, EREADY, EVICE, BFLAG (cont. ) 
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TABLE 7.7.1 - SCL BUFFER (3.01) - KEYBOARD/ZIP INPUT 


OFF LEN 
USE FORMAT 


STARTOFF START of data OFFset 
ENDOFF END of data OFFset 
56 SCLBUF SCL (keybard or zip) input buffer 


SCL BUFFER (3.01) - KEYBOARD/ZIP INPUT 
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TABLE 7.8.1 - CT.INFO (3.01) - CONFIGURATION TABLE INFO 


OFF LEN 

SET GTH FIELD 

© 2  CTENDDKS 
2 2  CTLENGTH 


USE 


2 times the number of disk drives on the systea 
length of the Configuration Table (fT) 


CT.INFO (3.01) - CONFIGURATION TABLE INFO 


FORMAT 


neta’ 


SECTION 8 


8. TASK RUN STRUCTURES 


This section explains the organisation and content of the 
different task structures. If an investigation of global 
MCP tables and memory layout reveals no cause of a failure, 
analysis of the contents of the task structures should be 
made to determine what action the tasks have most recently 
been performing. 


As explained in section 7.6.1, the MCP maintains a set of 
tasks called "independent runners". Only one of these tasks 
will have control at a particular time. A task structure 
may be printed out using the PRINT TASK option of PMB80. 

The CURRENT parameter causes the task currently in control 
to be printed. 


8.1 TASK ORGANISATION IN MEMORY 


the Task Control Blocks. Slice numbers O, 9 and 15 
are reserved for the MCP slices BAILIFF, AVR and 
SCL/LOADER discussed in section 8.2. The other 
slices in this range accommodate "user" TCBs as 
required. The TCB slice number is the same as the 
task mix number. 


Tasks are accessed through the slices numbered 0-15 


The MCP tasks are single slice tasks, and the slices 
contain both data and microcode segments. User tasks 
consist of three slices: a data slice (TCB), a program 
S-code slice (PCB) and an interpreter microcode slice 
(ICB). An exception to this is SORTINTRINS which is 

a microcoded program and so does not need an interpreter. 


A TCB is set up when a program is executed on the B80. 
The code and interpreter slices (PCB, TCB) for this program 


are created only if these slices are not already in memory. 


Program s-code and interpreter microcode is re-entrant, 
and therefore may be used by more than one task. 
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8. 


8 


ane 


TASK RUN STRUCTURES (CONT.) 


TASK ORGANISATION IN MEMORY  (CONT.) 


The TCB slice descriptor holds the index in the Slice 
Address Table (SAT) of the program and interpreter 
Slice addresses (fields SDPEO, SDIEO of Table 6.3.1 - 
RS MAP). These two links locate the slices in use hy 
a task, and these slices in turn hold the Data Segment 
Tables (DSTs). which locate all overlayable segments 
associated with the task. 


8.1.1 CONTENTS OF A TCB 


A TCB locked slice contains a slice descriptor; 

an S-Interpreter Work Area (SIWA); a Control 
Stack; a Data Segment Table (DST), and any 

locked segments including File Information Blocks. 


An interpreter needs a working storage area for 
each task which it is executing; this is the SIWA. 
The format of an SIWA depends on the interpreter, 
but always starts with an extension to the slice 
descriptor which provides the interface between 
the interpreter and the MCP, and hoids the memory 
addresses of the items within the locked slice. 


S-machine (refer to the CMS MCP Reference Manual 
for details of the S-languages). The control stack 
is also used by the MCP to store return addresses, 
as explained in section 7.4.2 


The DST holds the segment descriptors 
of data associated with this task. § 


SD MAP. 


o oO 


Any data segments which are not overlayable are also 
located within the locked TCB slice. Examples of 

locked segments are File Information Blocks (FIBs) 

for all open files (see section 8.6). The Data Stack 

(data segment 0) of MPLII programs is also a locked segment. 


8.1.2 CONTENTS OF A PCB 


A PCB locked slice contains a slice descriptor 


an optional preset area (CCBPA2) and a Data Segment 
Table. 


For COBOL and RPG programs, the COP table is treated 
as part of the S-code (it does not change at run time). 
It is included in the PCB, following directly after 
the slice descriptor. 


The DST contains the segment descriptors of all segments 
of s-code for the program. 


8. TASK RUN STRUCTURES (CONT.) 


8.2 


8.3 
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SYSTEM TASKS 


The system tasks are permanently present in the B80 mix 
although they are not evident in the response to the MX 
command. Detailed information about the contents of these 
TCBs is not usually required. 


8.2.1 BAILIFF TASK 


The Bailiff is task O. The function of this task is 
explained in section 7.6.3. Segment 6 of slice O is 
the TASK TABLE which contains the names of the tasks 
is the mix along with other information (see Tables 


8.2.1 and 8.2.2). This information is included in 
+h mmm Leen le amen ewet Je hee 42 WTA wer Soe dies gM IN cai 0S, Pane sas 
Cue ANGLySLS proviuca vy ele FRINL MiA OPlLON OL 
PMB8O. 


8.2.2 AVR TASK 


The Automatic Volume Recognition (AVR) task has 

mix number 9. The purpose of this task is to allow 

the AVR operation to run efficiently with other 

tasks. It is executed when peripherals (especially 
disks and cassettes) are brought on-line and made ready. 
The MCP AVR code resides in the OPENCLOSE slice (17). 


8.2.3 SCL/LOADER TASK 


This MCP task has mix number 15. The TCB references 

a large number of segments including work areas, FIBs and FPBs 
for code files and virtual memory files, and micro-code 
segments for performing various functions. 


USER TASKS 


With the exception of SORTINTRINS all programs create a run 
structure including three slices (TCB, PCB and ICB). The TCB 
contains the run time information of the program. It is usually 
necessary to understand the S-language involved to perform 

a detailed analysis of the TCB information. This is not, however, 
usually relevant to system dump analysis. The most relevant 
information is the exact function that the task was performing 
which might have caused the system failure. Consequently, 

only the general layout of the task structures is provided here. 


8. 


8—4 


TASK RUN STRUCTURES (CONT.) 


8.3 


8.4 


USER TASKS (CONT.) 


B31 COBOL AND RPG TASKS 
COBOL and RPG programs both use the same S-interpreter 
(COBOLINT), consequently their tasks have identical 
run structures. 
Each file declared in a program has three segments in 
the task structure: one FPB (Table 8.5.1), one FIB 
(Table 8.6.1) and one segment to contain the record 
work area. 
A file with indexed organisation has a larger FIB 
which includes an IFIB (Table 8.7.1) All FIBs are 
located within the TCB locked slice. 
Working storage has segments of size set by the COBOL 
dollar option DSSIZE with the limitation that segments 
occur on Ol levels. 
Program S-code is segmented as specified by the COBOL 
SECTION statement. 
The COP table is located within the PCB locked slice 
between the slice descriptor and the Data Segment Table. 
It is called CCBPA2 on a memory dump. 

8.3.2 MPLII (BIL) TASKS 


MPLII programs and BIL programs (the CMS compilers) 

share the same interpreter (BILINTERP). In MPL, all 

data that is not specifically declared within an overlayable 
segment resides in the Data Stack (data segment 0). This 
segment is located in the TCB locked slice of an MPL program. 
Each file declared has an FPB segment and an FIB segment 

in the task slice, the FIB being located within the locked 


TCB. 


The PCB (program code slice) contains only a slice 
descriptor and a Data Segment Table. 


COMMUNICATES AND FETCH VALUES 


If the execution of a particular task causes the system to 
fail, then the failure is more likely to have occurred while 
the MCP was performing a function related to the task, than 
while the task's normal S-code was being interpreted. 


8. TASK RUN STRUCTURES (CONT.) 


8.5 


8.6 


2015400 


COMMUNICATES AND FETCH VALUES (CONT.) 


A task makes a request to the MCP via a “communicate” S-Instruction. 


The last communicate can be found in the SIWA located within 

the task's TCB (see fields CPA.VERB and CPA of COBOL.TCB MAP 
Table 8.3.1, and field CPA of MTCB MAP Table 8.3.2). The value 
of the communicate indicates the function that the MCP is 
probably performing (see Table 8.4.1). This often directs 
attention to a specific Device Dependent Routine or Function 
Dependent Routine. This may be a clue to the writing of a small 
test program to attempt to create a reproducible occurrence of 
the problem. 


When the MCP completes a communicate request, it returns control 
to the task and puts a value in the TCB called the "fetch value" 
or Fetch Communicate Message (field FCM or MAP RS - Table 6.3.1). 
The value of this field indicates the result of the operation 
(see Table 8.4.2). 


FILE PARAMETER BLOCK (FPB) 


This data segment which is present in a program code file contains 
the initial values relating to a logical file. It contains 
sufficient information to enable a task to locate a physical 
file on a specific medium (see Table 8.5.1 - FPB MAP). The 
FPB in the code file can be changed with the MODIFY utility. 


FILE INFORMATION BLOCK (FIB) 


In addition to an FPB, a logical file has an FIB. If the file 
is closed, the information is small enough to reside ina 
special segment descriptor with a flags value of @48@ called a 
"vestigial FIB" (Table 8.6.2 VEST.FIB MAP). This descriptor 
resides in the DST of the TCB. When the logical file is opened, 


an FIB segment is created in the locked TCB slice and values 
inserted which reference the physical file. 


An FIB includes the file buffers with an I-O descriptor for each. 
When an I-O operation is to be performed on the file, one of 
these I-O descriptors is linked to a queue of descriptors called 
an I-O queue. Pointers to the queue are located in the PHT of 
the device involved (see Section 9). The I-O descriptors should 
be checked for valid contents, since invalid I-O information 
(which may be a result of a hardware fault) is a frequent cause 
of system failures. 


8. 


TASK RUN STRUCTURES (CONT.) 


INDEXED FILE INFORMATION BLOCK (IFIB) 


A logical file with the CMS indexed organisation consists of 
two physical files, a key file and a data file. The FIB of 
files with indexed organisation contains an IFIB which itself 
holds two buffers and I-O descriptors to the keyfile (see 
Table 8.7.1, IFIB MAP). 


8.3.1 USER TASK COMPONENTS IN MEMORY 


DST 


LOCKED 
SEGMENTS 


PCB 
SLICE 
DESCRIPTOR 


DST 


USER TASK COMPONENTS IN MEMORY 
ee ee ES 
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pointers 

to 
overlayable 
segments 


(disk 
and 
main 
memory 
copies) 


8.3.2 CCBOL/RPG TCB COMPONENTS 


FROM SAT 
SLICE DESCRIPTOR 
to PCB 
S—INTERPRETER 
/ WORK AREA ues 
for COBOLINT 
CONTROL STACK 
to 
DATA SEGMENT geneva 
a 
, TABEE segments 
FIB 
IODESCRIPTOR 
BUFFER 
IODESCRIPTOR 
BUFFER 
pink 
link 


IODESCRIPTOR 
BUFFER 


COBOL/RPG TCB COMPONENTS 


8.3.3 COBOL/RPG PCB COMPONENTS 


FROM SAT 


SLICE DESCRIPTOR 


COP TABLE 


to 
overlayable 
S—code 


DATA SEGMENT ments 


TABLE 


COBOL/RPG PCB COMPONENTS 
a COMPONENTS: 
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8.3.4 MPLII (BIL) TCB COMPONENTS 


SLICE DESCRIPTOR 


S—INTERPRETER 


to PCB 


Z| WORK AREA to ICB 
for BILINTERP 
s CONTROL STACK 
to 
DATA SEGMENT re aida 
ini TABLE asad 
link Fa 


DATA STACK 
(DATA SEGMENT 0) 


FIB 
IODESCRIPTOR 
BUFFER 


| 


MPLII (BIL) TCB COMPONENTS 
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TABLE G.i.4 - TASK TYPES 


TASK TYPE TCE EXAMPLES 


BATA + M-CODE BAILIFF, LOABER 
M-CODE UTILITY BATA H-CORE SORTINTRING 
S-CGDE UTILITY BATA §-COBE H-COBE SYS-SUPERUTL, COPY 
UStk TASK DATA §-COBE 4-CODE BCS, DOMAIN, THCS 


M-CODE = machine aicrocode 
S-CODE = secondary code executed by one of the virtual aachines !- 
MPLIT(BIL), COBOL/RPG, NDL. 


TASK TYPES 
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TABLE 8.2.1 - TASKTAE NAP (3.01) - TASK TABLE 


FF LER 
SET GOTH FIELD FORMAT 


BISTRT 

BTTOTAL TOTAL number of tasks in the atx 

BTTOTLSER Tilal number of USER tasks in the mtx 

BYHAXUSER MAXinum number of USER tasks atlowed in the ex 

BIXSUTIL nuaber af UTILitites with a user task-id (mix<id?) 

BLASTID Yask-1D of the LAST user task loaded TABLE 7.4.2 


0 
0 
1 
2 
3 
% 


YABLF 6.2.2 ~ TASK MAP (3.01) - TASK TABLE ENTRY 


OFF LEN 

SEY 6TH FIELD USE FORMAT 

G 7?  TeRIB prograa pack-id ASCII 

7 42 TRLID program file-id ASCII 

at 3 TREK pseudo fetch communicate message area (for ZIPs) TABLE 8.4.2 
* 3 TMPTR zero relative sector address of the Virtual Hemory 6 BR 

2? i TREST 2 z 

2 - — TENTRYSZ LABEL 


TASKTAB MAP (3.01) - TASK TABLE and 
TASK MAP (3.01) - TASK TABLE ENTRY 
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TABLE 8.3.1 - COBOL.TCB (3.01) - COBGL/APG INTERPRETER SINA 


OFF 
cET 


LEN 


am 
> 


Pom TNO Om fo of no fo fe tO 


sO nM eM we aA et 


SURBASE 
STKPTR 


PARTIAL ST 
VERSION 
DUMP. MESSAGE 
ZIP.AREA 
JOE. PACK 
RIX RUMBER 
iSEG 
PSEGPTR 
PSEGBASE 
CONN.MS6 
OVERFLOW 
LINE CNT 
HALT. POINT 
CPA.VERB 
CPA 
MULTIPLICAND 
XY REVERSE 
XY. SAVE 
SAVE. BESE: 
ZERO. CALL 
DP.CALL 
DP. CALL? 


cont..../ 
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task stice descriptor 


address of PCB tocked stice holding COP TABLE 


address of interpreter locked slice 


address of Bats Segment Table for this TCR stice 
address of first byte of the CONTROL STACK 


current pointer ia the control stack 
end cf the control stack 

TASK-ID of father (@80@ if not zipgad} 
mask to SINTFLAG 

FETCH VALUE area (updated by MOH) 
Program code SEbsent for &fd 

Program segaent DISPlacemant for BOd 
fength of PARTIAL STack 


BS/BP MESSAGE aumber 


current Interpreter SEGmant aumber 
Program SEGment table PIR 

current Program SEGment BASE address 
FETCH VALUE store area 

OVERFLOW s-register 

LINE COUNT s-register 

debug HALT tine number 

Communicate Parameter Area VERB 

CPA object and first parameter byte 
used in multiply routine 

used in edit routines 

used in subscripting and indexing 


used in decoding s-op parameters 
u 


COBOL.TCB (3.01) ~ COBOL/RPG INTERPRETER SIWA 
ree EE DO LWA 


FORMAT 


TABLE 6.3.1 
AA ER 
AA BR 


BINARY 
BER 
& ER 


BINARY 

AA BR 

AA ER 

TABLE 6.4.2 
BINARY 
BINARY 
BIHARY 
TABLE 8.4.1 
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TABLE 6.3.1 - COBOL.TEB (3.01) - COBOL/RPG INTERPRETER SIMA 


& 
st ecm cm 


- 
= 
= 


g 
on 


mo = co 


MODIFICATION.GK - 


COPLEXT 
EXT.PIR 

SAVE CPA 
HOBIFIER 
SUE.FACTGR 
HULTIFLIER 
INDEX COUNT 
ABS. SAVE 

XY BUMP 
SAVERY 

REAL ABS RIN 
XY STORE 
OPNBS SAVE 
CAT LENGTH 
REMAINDER 
NEG. BIVTSOR 
OPMBS. SAVE 
CATZ.DIEP 
GPHE4 SAVE 
CAT.SEG 

§. OP ABDRESS 
DIVISOR 
SPACES COURT 
SOURCE CGUNT 
SOURCE LENGTH 
SOURCE ADDR 
BEST LENGTH 
DEST APDR 
DEST FLAGS 
FLAG. SAVE 
RESULT S2ON 
BIVISOR. SION 


used to store COP EXTensions 
pointer to extensions 
SAVE communicate Parameter Area 


(cont.) 


used for holding subscript or index aodifier 


current subscript factar 
used in multiply routine 


number of iadices 
used for holding the absotutised descripta 


used for auaber reversing 


where to go if absolubise fails 
used in arithmetic operations 


“ 


used 
used 


used 


in CONCATENATE 
in DIVIDE 


in EXARINE 
in CONCATENATE 
in EXAMINE 
ia CONCATENATE 


offset of current S-QP within code segment 


used 


used 


u 
a 
u 
u 


u 

used 
used 
used 


CRET REMAINDER used 


ZERO. SAVE 
SIGN. DIGIT 
ZEROUR. SAVE 


- 


in BIVIDE 


in arithmetic routines 


in EBIT 
in MULTIPLY 
in DIVIDE 


in COMPARE REPEAT 


COBOL.TCB (3.01) - COBOL/RPG INTERPRETER SIWA 


(cont. ) 


TABLE 6.3.4 ~ COBOL.TCB (3.01) - COBOL/RFG INTERPRETER SINA (cont.) 


125 1 SAVE.SION - . 
26 1 EBIT.HASK - = 
“ #TESTE, SAVE = 
“8 SETB. SAVE = - 
w M ZERGL EO. SAVE : 
“ NREM.SIGN used in DIVIDE : 
127 i ODIVATYFE be = 
2G 1 FROCL. QUOT = - 
oF RECL - 7 
de? i FREEL.REM is . 
130 2 QUOT.LENGTH 7 = 
132 2 —«QUDT.ADBR = = 
1 2 QUOT. FLAGS = - 
5 1 | BYVD.LENGTH = - 
436 45 | QUOTIENT + - 
wo MO RESULT.FIELD 0 - = 
18i 14 BIYIDEND zy = 
“ M  END.OFRESULT = - 5 
7 32 ERIT.SHTE = = 
gee Je AEDBIT.SUTB fs . 
moi - EBTT. TABLE - - 
Bot 1 PLUS ENTRY = ASC 
262 1 9 MINUS. ENTRY = : 
265 1 BLANK.ENTRY = : 
Bo 1 AST.ENTRY = : 
263 1  POINT.ENTRY = i 
266 1  COHMALENTRY = ‘ 
267 1 BALLARENTRY — - c 
268 1 = 2ERO.ENTRY = - 


COBOL.TCB (3.01) - COBOL/RPG INTERPRETER SIWA (cont.) 
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OFF LEN 
SET 6TH FIELD 


a 
Spoon 
co) 
my 
eo] 
es 

> 
i= 
faa 
7 


10 2 = PSTA 

ie 2 sCESTA 

14 2 OSTA 

14 2 CSE 

ig 2 5A 

ao 2 CSL 

2 - ~~ OSTWA 
| TASK. ID 
23 2 | SINTHASK 
2 3 FETCRV 
2% 3 SSA 

Si 2 OP STACK 
1 ISEG& 

% 2 CEALPIR 
34 2 «CPA 

HH 1 OCPALVE 
374 CPA. DB 
33 22) OC PALREST 
& 4 CONH.ERR 
44 2 CSEDB 
63 1 ERRNO 
& 3 COMM MESSAGE 


TABLE 8.3.2 - MTCB MAP - MPLII (BIL) INTERPRETER WORK AREA 


task slice descriptor 

Program Segment Table Address - code DST 
Interpreter Segment Table Address 

Data Segeant Table Address 

Control Stack Base Address 

Control Skack Address (current pointer? 
Controt Stack Liart address 


TASK ID of the originator (@80@ if not ZIPped) 
nask to SINTFLAG 

FETCH communicate Value returned by MCH 

S-code Start Address (segment + offset? 

Partiat STACK fength (user part of control stack) 
Interpreter SEGment number (=@00@ on 3.01) 

work pointer in UPA 

Communicate Parameter Area 

CPA Verb 

CPA OBdect (adverb) 


COMNHunicabe s-o, (@43@=CONNE, @734=COKN) 
current Code SEGaeat Base address 
internal ERRror number 

fetch CONHunicabea MESSAGE 


updated by interpreter and accessed by FETCH.VALUE 


TABLE 6.3.1 
AA ER 
AA ER 
AA ER 
AA ER 
AA ER 
AA BR 
LABEL 
TABLE 


SUBSCRIPT 
AA BR 
TABLE 6.4.1 


Aa BR 


TABLE 6.4.2 


MTCB MAP - MPLII (BIL) INTERPRETER WORK AREA 
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TADLE 8.3.2 - MTCE NAP - MPLIIT (BIL) INTERPRETER WORK AREA (cont. ) 


6? 
8 


2015400 


A Re me A PO me Ue A Re 


rm 


eM fy Ae oom 


LLM 
RLY 

LBA 

RBA 

PSN 

CPH 

PCA 

PRO 

HOBE 

CARRY 

NHR 

NLD 

LVL 

STB 

STL 

BISPLAY 
HADUMEABDR 
XYSTORE 
BOSTORE 

Bas THRE 
STASTORE 
GETSEG.Hi 
GETSEG B32 
GETSES. M2 
DATA. SEG. STATS 
CODE. SEG. STATS 
YSN 

HSPALE 


ee a Ce ae nn EER EY 


MTCB MAP - MPLII (BIL) INTERPRETER WORK AREA (cont.) 


Lexical Level containing aost-accessed data 
next-aost-fraquently-accessed-data level 
DISPLAY vatus of LLM 

DISPLAY vatue of RLN 

current Progeee Segment Number 

Current Frocedure Huaber (within the segment) 


Program Current Address (offset within code segment) 


current offset within PROcedure 

@608 = execution, G18 = remap or deciaration 
CARRY software register 

Nuaber of Message Reference bytes used 


Next Local Bescriptor (number within this procedure) 


current jexical LeVeL 

gaia Stack fase address (data segmeat 0} 
data STack Leagth 

1é*(id-bit) indexes in the data stack 
processor register store areas 

a 


al 
“ 
uw 
register inforaation for HCP GETSEG operation 
it 


Virtual Segment Number for BOd 
aaximun size of Message reference table 


BINARY 
BINARY 


BINARY 
BINARY 
BINARY 
eIMARY 


BINARY 


- 


BINARY 
& BR 
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TAoLE b.4.d - Gunfbaicnit VERDES 


CLASS VERB BITS COMMUNICATE (byte 0 = verb, byte 1 = object) 


§ 00-0F FILE ASSIGNKENT (object = FIB segment nugber) 
01 - FILE GPER 

8 G2 - FILE CLOSE 

C iQ-2F FIELD GRIENTED I-G (object = segment number? 
Ls . Oi = ZIF 

c 7 02 DISPLAY 

C is 04 PAUSE 

C ‘ 08 = CONBITIONAL 

C 20 - — ACLEPT 

B 40-3F DATA COMMUNCATIONS 

E 40 - — -BATE-TINE 

E 41 - TERMINATE 

E 42 - WAIT 

E 43 - — SYSTEM STATUS 

F 70-7F MACHINE BEPENDENT (880) 
& 70 - -YEELD 

F 71 -  GETSE6 

F 72 - —- PUITSES 

F 73 - — -PUTLP 

fF 74 ~ SUSPEND 

A 80-9F FILE TYPE I-O (object = FIG segment number? 
Ai " Of CONDITIONAL CONHUNICATE 
A 80 ~ TEST STATUS 

a &2 ~- READ (not CONSOLE) 

a 54 ~ WRITE (not CONSOLE? 

3) et) - REWRITE 

rs) 88 - ‘DELETE 

a BA - STREAM CONTROL 

a &C - — START 

a BE -  GVERURIT 

A 90 ~ —-REAB-HRITE 

3) 92 ~- READ (CONSGLE} 

A + - WRITE (CONSOLE) 

A or) - ‘GET 

A 96 - PUT 

i) 9A - REDEFINE WORKAREA 


COMMUNICATE VERBS 
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FILE HANDLING COMMUNICATES 


aQ 10 - 


SUBseeee 


fy 
3 
hel 
= 
oat 
oS 


ao FG 4G 


RESULT GF 


TABLE 6.4.2 - FETCH VALUES 


SUCCESSFUL 
QUEUE EMPTY on receive with NO BATA option 

FATAL ERROR occurred during communicate 

ExD OF FILE encountered on sequential input 

INVALID KEY 

INVALIB KEY - sequence error aon output to indexed file 
INVALIG KEY - duplicate key on indaxed fife 

TRVALID KEY - no such record exists 

INVALID KEY - boundary violation (e.g. write past EOF) 
PERMANERT ERROR 

PERMANENT ERROR - detected on read from data file 
PERNANENT EXRGR - detected on write ta data file 

PERMANENT FRAOR - detected on read from key fife 

FORNANEMT ERROR - detected on write to key file 
CONDITIONAL FAILURE (bytes 1 and 2 = the CMS event number) 
FATAL ERROR (bytes 1 and 2 = the CHS event auaber} 


ZIP COMMUNICATE 


oo ne te nt a ey An wt Oe re es ee 


SUCCESSFUL (bytes 1 and 2 may contain a stop value) 
program file not found 

interpreter file aot found 

insufficient meaory 

no user disk fora virtual menory file 

fult Bex 

usercount error 

dupticate pack (two packs with same id) 

invalid load raquast 

NCS already precent in aix 

disk error 

code file error 

illegal data comm load request 

program BS’ed (ZIP PAUSE only) 

program BP‘ed (ZIP PAUSE only? 

SUPER UTILITY busy (CH RM PR etc.) 

CONDITIONAL FAILURE (bytes 4 and 2 = the CMS evant nusbar) 
FATAL ERECR (bytes t and 2 = the CHS event number} 


FETCH VALUES (cont.) 


TABLE &.4.2 - FETCH VALUES 


SUCCESSFUL CONSOLE COMMUNCIATE RESULTS 


Po 


8—20 


set if the C-KEY was depressed 
set if Lhe M-KEY was pressed 
reserved 

GCKI to GCKIIIT respactivaty 
PKL to PRE4 recpectively 


FETCH VALUES 


TAELE 8.5.4 - FRE MAP (3.01) - FILE PARAMETER BLOCK 


Gee LEN 


SEY OTH FIELB 
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ru 


F 


am TI be A me ee ET OT SU ee Ue ee eh Se 


FPEILNG 
FPEPKIE 
FREMFID 
FPEFLID 


FPERLNG 
FREFLTP 
FPEHREN 
FPBEVCK 
FPEBSTI 
FPBHKAD 
FPERCSZ 
FPEBFSZ 
FREMXS2 
FPEROEF 
FPEFLAG 
FREADCL 
FREADOP 
FRECYE? 
FREGNNO 
FRECRDT 
PRELABT 
FRESPEY 
FPESYFR 
IFFE.DFPIG 
TFPE. OFF ID 


IFPBRTSZ 


IFPE.KSZ 
IFPELKOFFS 
IF PB. ZEROS 
IFPE ERD 


INTERPRETATION 

Implementation Level (currently=0) 
PACK IB, VOLUME ID/NULTIFILE ID 

“ul 


FILE ID 

space (820@) 

REEL NO (000-999 jact) 

FILE TYFE 

Highest Record Number writtea to file 
DEVICE KIND 

fata Segment Table Index of record workarea 
Work Area Offset within above segment 


arannnw ater 


ACCORD SILC 

BUFFER (block? SIZE 

Maxinun File Size (in records) 
umber Of buffers 

FLAGS 

communicate adverb for CLOSE 
communtcate adverb for open 
CYCLE ausber 

GENERATION number 

CREATION BATE O:¢DDD} 

LAST ACCESS DATE (YYBDD) 

SPARE BYTES in fast stream record 
SAVE FACTOR 


Indexed Fils Parameter Block Data File Pack If 


fata Fite IB 

Spare (8200) 

spara (8008) 

Rough Table Size (sectors) 

zero (8008) 

KEY SIZE {bytes} 

KEY OFFSE? (bytes) 

#000000008 

end of indexed file extension to FRB 


FPB MAP (3.01) - FILE PARAMETER BLOCK 


FORHAT 
BERARY 
ASCII 


ASCII 

ASCII 

ASETI 

TABLE 10.3.4 
BINARY 
TABLE 8.5.2 
BINARY 
BINARY 
BINARY 
BENARY 
BINARY 
BINARY 
TABLE 8.5.3 
TABLE 05.4 
TAELE @.5.5 
aSCTl 
SENARY 
ASE] 

ASCII 
BINARY 
ASCH} 

ASCTT 

ASCII 

ASC} 


BINARY 


BINARY 
BINARY 


LABEL 
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8-22 


TABLE €.5.2 - BEVICE KINDS 


FAMILY VALUE BEVICE 


PRINTER FAMILY 

any Printer 

Console (Keyboard only) 

Serial Printer 

Console (Printer) 

Line Printer 

CARB FAMILY 

set = Card Reader 

sel = Card Purch 

set = &O colugn cards only 
set = 94 cotuan cards only 
SCREEN FAMILY 

Console (Printer or Screen? 
Console (Screen) 
IMPLEMENTATION DEPENBANT (BEO} 
Asyrc Bata Cona 

Real Tise Clock 

Industry Compatible Mint Disk CICMD) 
NRZ or PE MAGNETIC TAPE 

PE TAPE 

NRZ TAPE 

always set 

set = write permit required 
set = Reel tape only 

set = Cassette tape only 

DISK FAHILY 

fiay Bisk with 180 byte sectors 
Burroughs Super Mini Bisk (BOMB? 
Bisk Cartridge 

201-1 Fixed bisk 

Disk Pack 


DEVICE KINDS 


MNEMUNIC 
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TABLE 8.5.3 - FP8 FLAGS 


EIT MASK INTERPRETATION 


7 


Om fu Gi & OO 


80 


set for special formas (printer files) 

gat if duplicate file atlowead (indexed fifes} 

set to use FPS to update last access and creation date (close) 
set if no label record (aagnebic tape and printer files} 

set for conditional open and close 

set if single area disk file to be created 

set for generation number check on open or update on close 
set for non-standard translate (E&CBIC fites} 

reseryad 


FPB FLAGS 
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TASLE 8.5.4 - ADVERE FOR OPER 


BITS MASK VALUE INTERPRETATION 


15 £000 reserved 

14 4000 1 open EXTEND 

13-12 3006 DTHERUSE 

- " 11,10 free access (noraal) 

_ - 01 tock access (other users may onty read) 
: 00 fock (no other users allowed? 
11-1 6000 HYUSE 

tg ‘ iQ gutpul 

" “Gi input 

= : il input-output 

3-6 0506 reserved 

a4 0030 ACCESSNOBE 

" "00 itlegal 

" = et randon 

" “ 40 sequential 

7 “ 1it 0 strean 

3-0 = GOOF raservad 


YABLE 6.5.5 - ADVERE FOR CLOSE 


BITS MASK VALUE INTERPRETATION 


7 £0  - reserved 
a 4G close with no rewind 
Me Ot & changa reet leaving Tile opan 


5-3 38 600 half close 

N * O11 clase with tock 

. " 401 close with purge 

3 111s close with remove 

ut " GGi «clase with release 

ae atl other combinations treated as half-close 


| a crunch 
i 02 1 merge overflow region into index region of indexed tite 
G 7 reserved 


ADVERB FOR OPEN and 
ADVERB FOR CLOSE 
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TABLE 6.6.4 - MEIGS MAP (3.01) - FILE INFORMATION BLOCK 


CFF LEN 
SET GTH FIELD INTERPRETATION FORMAT 


QO -  FIB LABEL 

O 1 FIBFLST Filestate TABLE 8.4.3 
t 2 FIBFPEN associated FPS segment number BINARY 

2 2 WFERIX Directory Index of associated disk file (disk only? B BR 

“8 FIBDRIX " 7 

3 2 YVFCTO Configuration Table Offsat (vestigial FIB onty) SUBSCRIPT 
% 2 FIBDREX secondary file Birectory Index B OBR 

& i FIBRSTI Data Segment Table Index for record workarea INDEX 

7 28  FIBYKAO fffset of the Workarea in the above segment’ § BR 

9 2  FIBTRL transfer fength £ OER 

th 1) FIBTECH File TECHniaue TABLE 214.4 
12 i) FIEQTHUSE File OTHERUSE - 

430100 FIBOPCL OPEN CLOSE flags . 

144 1 FIBREUF nunber of Records per Suffer BINARY 

13 2  FIBCROF self relative address of current 10 descriptor ER BR 

17 2 FIBFTR Buffer Pointer ae 

19 2 FIBRCSZ Record Size BOER 

SL 2 FIBEFSZ Buffer Size B OEE 

23 2 FIBFUTREUF number of bytes feft in buffer (after PUT? EER 

a “ FI8SRD u a“ 

my 2 FIBSUA Stream I-0 Mork Area - 

2? 1 FIODVCK actual device kind TABLE §.5.2 
23 2 FIBPHTA Peripheral Handling Table address AA BR 

X i FLBLNDO current 1-0 descriptor queue head index INDEX 

Ji 3 FIBCRY Current Record Number B OBR 

4H ~-  FLGNBDT end of non-disk non-console FIB LABEL 


MFIB MAP (3.01) - FILE INFORMATION BLOCK 
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JARLE G.é.1 - ARLE HAP G02) - File TakOReATION BLGcK (cont? 


Se 2 FISCONSIZE (CONS) nunber of cofuans on a console device B ER 
A 9 FIGHRR (DISK) Hext Record to be Read 8 BR 
3 12 FIBHEPOS (CONS) cotuen position of print head BINARY 
37 3 OF TBLERA (DISK) fast Bisk record Accessed B BR 
3 PO FYDLOGICALHAPOS (CONS) Logical print Head Position B BR 
40 14 FIBINBICS (CONS) Keyboard Indicators (lights) 5 

40 2  FIBSEL (BISE) Suffer fength in SECtars B BR 
40 3° FIEMRAP (DISK) Maxiaium Record Number in current Area BOER 
45 3  FIBMRY (DISK) Maxtaum Record Wri then B BR 
46 3  FIBHRD (DISK) Maximum Record fectared B OBR 
St oi FIEARY (DISK) Humber of Areas allocated BINARY 
te i FLBPRUR (BISK) Primary Disk Unit Number (@FF@eunal located) = 

Sd 40 FLeSCuY (BISK) Secondary disk Unit Huaber (@FF@sunatlocated) = - 

4 2 FIBILINK (DISK) fink to indexed file flags CLEEYFLAG) SR ER 
S46 2  FIBTAE (CONS) TAB cotuan number B BR 
54 - FIBBFH (DISK) memory Disk File Header LABE 
56 2 FIBLAL (DISK) number of sectors in disk area l BOR 
“9 3 FIBDAI (DISK) sector address of disk area 1 BOER 
al 73 ~ (DISK) 25 more length-address pairs - 

4736 -  FIBEND end of FIB for DISK files LABEL 


MFIB MAP (3.01) - FILE INFORMATION BLOCK 
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a. NOTA ee ASR A tA BAe ett septa 


TADLE 6.6.2 - MAP VEST.FIG (3.01) - VESTIGIAL FIB 


OFF LEW 

SET GTH FIELB INTERPRETATION 

VEST.FIE.FLAGS «segment descriptor flags (=C48@ 

VEST FIR. 8A5E segment base (points to fitestate below} 

VEST FIS.FS Tilestate 

VEST FIBAFPS associated FPR cegnent sumbter 

VEST. FIG ERX (DISK) Biractory Index of File (2 B-bit values} 
VEST.FIG.OFFCT © (NON-DISK) Offset of Configuration Table 

VEST. FIB. BU (DISK) Besk Unit 


TABLE 8.46.3 - FID FILESTATE 
BITS MASK VALUE INTERPRETATION 


7 86 80 Sequential Oraganisation (not Indexed) 
&3 40 I-G HASK 

“40-400 Gutput alloued 

"20 20 Input allowed 


4-5 18 ACCESS TECHNIQUE 
: G0 Streae 

" 68 Console 

us 10 Randos 

“ 18 8=©Sequential 


@ 04 04 End Of Fite not reached 
i 8602 602) File Half Closed 
G 


ot 060 Streas 


MAP VEST.FIB (3.01) - VESTIGIAL FIB- and 
FIB FILESTATE 
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FORMAT 


TABLE 6.4.2 
fa ER 

TAELE 8.4.4 
BINARY 
BINARY 

RA ER 
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TABLE 8.4.4 - FIB FILETECHNIQUE 


BIT MASK INTERPRETATION 
60 Sort Intrinsic (no data transfer) 
40 Exception 
20) «Unit Exhausted 
Last Coma was START 
09 Last Comm was WRITE 
04 Last Coma was READ 
02 Last Coma was not failed Conditional 
Of Buffering fhead Invoked (Dynamic Access} 


Ce Marian | 
—~ 
So 


FIB FILETECHNIQUE 
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TAHLE B74 ~ HAP FTE (3.01) - INDEXED FILE INFORMATION BLOCK 
ci} OTN FIELD 


1 IKEYFLAG 
"TKEYALLOC 


"OM TFIBFLAS 

1 40 IFIGKEZ 

2 4  IFIGKEN 

3 1 TFIBAGREFLAS 
4 2  IKEYOFFU 

“ NTFIBREYO 

4 2  TREYELY 
“8 UFISFIB 

8 2  IKEYSLU 
“4 FFIFBRN 

10 t  IXEYCAU 
tii) IFIBEEYS 
te 1 IFIBSAREAT 
1302 FIBDISKOFFI 
15 2 IFIBDISKOFFO 
17 3 IKEYSIZEI 
NN TFIBLAN 

20 2 IFIBSRT 

ve 4 IFIBOSA 

23 2  IKEYRTS 

so 2) IFIBPARTS 
26 3° IFISSI7EOFLOW 
oF 208 - 

2? 1 IFIBCAT 

40 1 IFIBHAI 

31 2  IFTELBI 
332s IFISOFFI 

33 18 «IFISDEST 
33 184 IFIBBUFT 
237 268 - 

443 2 IFIBDRIX 
44? 10 TFIBDUN 
448 - IFIBDFK 
446 2 IFIBLAL 

450 2 IFIBBAL 
402 60 - 
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S12 - 


IF IBEND 


INTERPRETATION 

status flags 

number af areas to allocate initially 
tlags 

actual Key Size in bytes 

Key Entry Size in bytes (one of & 14 24 32) 
gore flags 

close merge output buffer offset 

Key Offset from base of data record 
Close merge fast disk address output 
relative address of related FIg 

close merge sectors left in out area 
Record Number 

close merge current area output 


Start of index area 

Sector Gffset into first Index Area 

Sector Offset of first Qverfloy Area 

Size of new Index (sectors) 

Logical Record Number 

disk rough table start address (@0G@=unallocabed) 
Overflow Start Area (GFF @=unal located) 
altocated Rough Table Size in sectors 

nunber of parts in the key 

size of the averflow area 

Index region buffer paranetars 

Current Area Index/BIMARY 

Maxigum frea Index (FF@=no index allocated) 
last disk sector used in index 

byte offsat into index buffer 


1-0 descriptor for index region 


index ragion Buffer 

a simitar table for the averflow region 
Directory Index of BFH of keyfite 

Disk Untt Number of Keyfite 

memory Disk File Header for the Key file 
Length of first disk Area 

sector address of first Disk Area 

13 more length-address pairs 


MAP IFIB (3.01) ~- INDEXED FILE INFORMATION BLOCK 


_ LABEL 


FORHAT 
TABLE 8.7.2 


BINARY 
TABLE &.7.3 
BBR 

& ER 
BOER 
RA ER 
B Bf 

B OBR 
BIRARY 
EINARY 
B Bt 


BINARY 

8 BR 

& ER 

TAELE 9.93.9 


BER 
BINARY 


B BR 
BBR 
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TABLE @.7.2 - IKEYFLAS 


BIT MASK INTERPRETATION 


1 


1 = sequential, 0 = randoa 

hardware search successful 

current record pointer points toa last record 

read was tha last operation 

overflow region contains useful information 

1 = record pointer is in index region, O = in overflow regiog 
read-next allowed 

duplicate keys nol allowed 


7? 
& 
5 
4 
3 
2 
i 
G 


TABLE 8.7.3 - IF IBMOREFLAG 
BIT MASK INTERPRETATION 


need to allocate an area 

End Of File detected on random read-next 
rewr ite-ovarwrite record search 

reseryad 

open/close index flag 


IKEYFLAG and 
IFIBMOREFLAG 
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SECTION 9 


9. LOGICAL AND PHYSICAL I-O 


The task file structures (FPBs and FIBs) (see section 8) relate 
to the actual input-output media through Peripheral Handling 
Tables (PHTs) and queues of I-O descriptors. This section 
discusses how I-O operations are achieved by the MCP code 
concerned: Master Interrupt Poocessor (MIP), I-O Queue Handler, 
Device Dependent Routines (DDRs), Master Communicate Handler (MCH) 
and the Openclose slice. 


The contents of the PHTs and I-O queues are often important for 
solving problems, especially where hardware faults are concerned. 
They can be printed using the PRINT PHT option of PMBS8O. 


921 COMMUNICATES - MCH AND OPEN CLOSE 


All input-output operations are performed by the MCP. 

A task issues a communicate which is decoded by the Master 
Communicate Handler. Not all communicates are I-O oriented, 
and I-O communicates do not always initiate a physical 
input-output operation. 


Although the MCP performs its own I-O operations to devices, 
all task I-O is performed throvah a logical file structure. 
This structure is centered on a File Information Block. 

All logical I-O operations (open, close, read, write) are 
performed by a task through this FIB. 


The MCP Openclose slice (slice 17), contains a Configuration 
Table (Table 9.1.1 - CT MAP) which contains logical device 
information including file-id, multifile-id, and logical 
device status. 


The CT has an entry for each device on the system. When a 
file-open communicate is issued by a task, a link is established 
between the FIB and the CT entry. At the same time, a link is 
established between the FIB and the PHT (see Section 9.2) for 
the channel which accesses the device. The FIB is initialised 
with informaton from these tables and space is reserved for file 
buffers. These links, which are illustrated in Figure 9.1.1, 
should be checked on any dump where a failure in logical I-O 

is suspected. 


The CT is maintained by the AVR task. The contents of 
the CT are analysed by the PRINT OL option of PMBS8O. 
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9. 
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LOGICAL AND PHYSICAL I-O (CONT.) 


9.2 


PERIPHERAL HANDLING - MIP AND DDRS 


The actual work of input-output operations is performed 
by the Master Interrupt Processor and the Device Dependent 
Routines. The MIP performs only the simplest "read-more" 
or "write-more" controller commands. the DDR for the 
particular controller handles the more complicated I-0O 
operations, which are usually dependent on the controller 
involved. 


Information on the physical status of the channel controller 
and device, and the logical status of the DDR for that device, 
are stored in a Peripheral Handling Table (Table 9.2.1 - 

PHTH MAP) and its device dependent extension. The field 
PHT.CIRC.BUF is a circular buffer of historical status information. 
Each entry is two bytes and the field PHT.CIRC.PTR is the 

index of the latest entry. The first byte of each entry is the 
device status received from the controller (see Tables 9.2.4 

to 9.2.8): the second byte is the S-flags which are used by 

the MIP and DDRs to determine the activity which is currently 
being performed on the channel. 


The interpretation of the device status byte is dependent on 

the appropriate hardware controller. S-flags consist of 

two parts. The most significant digit defines the type of 
operation being performed. The least significant digit is 

used, in combination with the channel status, to determine which 
MIP or DDR code should be performed. Each DDR contains a switch 
table to achieve this analysis; these details are not normally 
required, and are not discussed further in this document. 


As a general rule, if the most significant bit of the device 
status is reset then the cause of the problem may be in this area, 
and should be investigated further. 


9. LOGICAL AND PHYSICAL I-0O 
eee 


9.3 
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INPUT-OUTPUT OPERATIONS ~- I-O QUEUE HANDLER 


The PHTs are located at the high-address end of page zero 
memory. Each PHT holds one or more I-O descriptor queue 
heads (Table 9.3.1 - QHEAD MAP). 


All I-O operations are performed as specified by the top 

I-O descriptor on the appropriate channel PHT queue. The 
actual I-O descriptor is found at a memory location which 
depends upon its origin (for example, the Virtual Memory 

I-O descriptor is located in the global MCP map VMWA, and 
descriptors for task-initiated I-O operations are located 
within the appropriate FIB in the locked TCB slice. 


The descriptor queues are analysed by the PRINT PHT option 
of PMB80, and the queue structure should be checked for 
consistency, starting with the queue heads and following 
the links to the descriptors. 


A queue head contains a flag field (Table 9.3.2) giving the 
status of the queue, and current descriptor and final descriptor 
memory addresses. 


Note that the queue head contained within DISK PHTs does not 
point to a queue of I-O descriptors but to the disk parameter 
area (Table 9.2.3 - DSKPM MAP). 


Each I-O descriptor has the same format (Table 9.3.3 - IODESC 
MAP). Console I-O however, uses some of the fields ina 
different manner 


Field IODFL indicates the operation to be performed, and the 
result of the I-O operation when completed (see Table 9.3.5). 
Field IODPM is the task-id (Table 7.6.2) of the task which 
requested the operation, 


Gd LOGICAL AND PHYSTCAL I-O STRUCTURE 


> FILE ae 
BUFFER related) 
file 
structure 
FPB 
RECORD WORK AREA 


LOGICAL DEVICE TABLE 


i ee 


structure 


PHYSICAL CHANNEL TABLE 


LOGICAL AND PHYSICAL I-O STRUCTURE 


TABLE 9.1.1 - CT MAP (3.01) - CONFIGURATION TABLE 


OFF LEN 
SET STH FIELD 


O 1 CTFLAG 

1 oi CTFLAG. DISK 
2 6 CTCAN 

§ 7? CTFLIB 

iS 1 CTRLRD 

i 1 UTRUST 

if 1 CINOTK 

17 1 CTDAYL 

1B 1 OCTDYNO 

i? 1 CTDVEK 

2) 1 CTPHTA 

fe i CTRHDO 

23 1 CTRSKN 

23) i CTeNTO 

a 2 CY KB.SS.LINK 
*% 2 CTDELA 

2h 2 CTRESZ 

26 2 CT KB.SPLINE 
26 2  CTDDIN 

oo 2  CT.DYNAMIC.LINK 
 -  CTSiZe 


Configuration Table FLAGs 

special disk flags 

physical td 

MULTIFILE, VOLUME, or PACK ID 

Reef number for tapes 

Nuaber of sectors per track (disk devices) 
Number of TRACKS par CYLINDER 

Directory length 

Device Number ("A", "BN, "C" etc.) 

DEVICE INE (CMS STANDARD) 

PHT address for this device 

Qucue Head Offeet for this device 

ESCT task-id of task holding this device 
nuaber of open files on this device (disks only) 
LINK of Self-Scan CY entry (keyboard CT onfy) 
used for keyboard screen CONSOLE combinations 
Hisk sector number of first BFH 

Record Size (nen disk) 

LINK to Serial Printer CT entry 

used for keyboard printer CONSOLE file combinations 
Disk directory inforaation 

memory LINK work area 


TABLE 9.4.2 - CONFIGURATION TABLE FLAGS - FIELD CTFLAG OF HAP CT 


BETTS MASK INTERPRETATION 


wo ot of 
Law) 


D— Gf UF thR NI 
he 
on © 

A ee ee 
W 


dayvice PRWERED OFF 

device REMINDING 

this entry LINKED to next entry in CT 
device READY 

HULTIFILE MEDIA 

SYSTEMS DISK 

device UNLABELLED 

NOT LAST ENTRY in Configuration Table 


CT MAP (3.01) - CONFIGURATION TABLE and 


CONFIGURATION TABLE FLAGS - FIELD CRFLAG OF MAP CT 
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FORMAT 


AECTT 

ASCII 
BINARY 
BINARY 
BINARY 
BINARY 
ASCII 

TABLE 8.5.2 
AA ER 

THPEX 

TABLE 7.4.2 
BINARY 

RA ER 
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OFF LEN 
SET OTH FIELD 


O - — PRTHD 
G 2  PrHTDDR 


2 44 FHT CIRC. SUF 


16 i SHT.CIRC. PTS 
17 1 ~~ PHTSA 
18 1 PHTSTAT 
19 2 | PHTEPLsS 
30 2  PHTBLIM 
ve 2 PHTRCLN 
™ @ FHTEFTR 
26 2 RHIRCLT 
228 4 PHTPSZ 
29 4 PHISFIN 
% i PRTABDR 
31 40 PHTSUBCHAH 
3 1 | PHISUBPRI 
XS 4 PHTMAXQHO 
uo BHT H@ND 
% 1 PHTICONO 
25 -  PHTEND 
25 - SHDOFST 
NOTE 1 
NOTE 2 
NOTE 3 


ere ernnmenten 
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Aa 


TABLE 9.2.1 ~ PHTH (3.44: 


—— 


~ PERIFECSL HANDLING TABLE 


hemory address af oh slice descriptor 
QO00GU for a CHANHEL EXPANDER 

historical ouffer of twa byte entries 
status byte and a-flag byte (coe below) 
index of current entry in buffar above 
Status Kssk (stored by BBR) 

STATUS byte obtained from hardware 

BBR S-FLABS (what is the device doing 7) 
fength transferred 50 far 

record fength 

buffer pointer 

record jength left to traasfer 

physical controller buffer siza (transfer length) 
accumulation of error conditions 

to be transferred to IQDESC 

channel address (one bit sat} 
sub-channel address (channel expancer) 
sub-channel priority 

number of bytes for q-heads 


qrhead ot queue being processed 
7 


if PHTSMH LOGICAL-GR PHTSTAT is not = GFFR 
then an exception condition has arisen’ 


a gueye entry is & bytes fond, most channels 


have ¢ I-G queues givind a maximum queue of G08 
y & 


and possible current queue nuabers of GO0@ or 68 


or GFF@ if no queue is in use 


the ranainder of this map ts the first 1-0 queue 
for this channel, refer to TABLE 9.3.1 


ene 


PHTE (3.01) - PERIPHERAL HANDLING TABLE 


FORMAT 


NOTE 2 


NOTE 2 
Lapel 


Aero e 


NOTE 3 


TABLE 
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Fa beh 
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9.2.2 - CHANNEL ADDRESSES 


CHANNEL ADDRESSEE 


GTH FIELD 


n ee mh eee ee OU PO ee ee ee ee ] 


DEKPST 

BORSFL 

BSEP RETRY COUNT 
BSEF MRITE. READ RETR 
DSEP RECCRD SIZE 
DSEFFe 

BSKPSF 

BSKPFL 

BSKPEA 

DSKPB2 

BSKFMA 

BRSPHA 

BSRPAQ 

DSEPCB 

oe 

GSRPPE i 

pskess 

DSKPED 


flags used by the DISK DBR 
count of all retries on the drive 
raad-afber-write retry count 


buffer size ‘record siza for seetter-#ather) 
functioa 2 

initial value of s-flazs 

function i 

Disk Address (ze cor nawbher) 


ro relative § 
initial disk address 
Palanicis genes: 

ae et Psat 
Cylinder Bit wask 
Initial Sector of this transfer 
Primary Status byte 

Secondary Status byte 


$ 
35 
S 


DSKPM MAP (3.01) - PHT DISK PARAMETER AREA 
SPE ate eee 


FORKAT 


NUNAR iY 
BINARY 
B Bg 


TABLE 9.2.4 


3 oo Oa oo oon 
oe om 02a oe oa 
ft pa Pe a a 


BINARY 
TABLE 9.2.4 


LABEL 
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TABLE 9.2.4 - DISK STATUS BYTES 
PRIMARY STATUS: 


BITS MASK INTERPRETATION 

deive MOT QE (lovical AND of bits 24 4} 

SEEK INCOMPLETE aftar a seek operation (otherwise 1) 
drive HOT UPERATIOMAL 

{ STATUS (see below) 

SEARCH INCOMPLETE after search aperabion (obherwise 1) 
EXG OF CYLIADER on read, write or search operation 
SEEK COMPLETE after seek operation (otherwise 1) 

upser detve, 1 = fower drive 


De | 


fh HO Tt 


ee he Ot fs UT Oe 
=> 
ma 


CECUNDARY STAtUS? 


DLTS MASK INTERPRETATION 
8G 6G = GEVICE ERROR (e.g. switched off) 
= ILLEGAL COMMAND sequence used 


Q = LAC (parity) error 
10 @ = required SECTOR NOT FOUND 
3 08 O = drive WRITE IMUTBIT 
* 04 0 = ILLEGAL SEEK operation (obherwise 1) 
i 02 6 = head MOT OX CYLINDER required for read, write or search 
O Gt d= EQUAL condition after a search operation (otherwise 0) 


DISK STATUS BYTE 
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TAGLE 9.2.5 - CASSETTE STATUS BYTE 


BITS MASK INTERPRETATION 
OK (refer to the soft controfler status values) 
NOT OK (refer to the other bits below) 

HOT AVATLABLE 

REEL detected 

: ERROR 

INYJALIE CORMAND sequence 
TAPE HARK detacted 
BATA STROBE FAIL 
WRITE INHIBITED with write type command 


" 


7 
7 
6 
se) 
ss 
3 
2 
i 
0 


CASSETTE STATUS BYTE and 
VALUE INTERPRETATION 
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& cps SERTAL PRINTER: 


BETS MASK INTERPRETATION 


7 8 @ = NOT OK 

& 40 0 = VOLTAGES BAD 

5 20 0 = NO PAPER 

4 10 atways set 

3 20 = FORMS MOTOR ERROR 

2 4 0 = CARRIER ERROR (jamued or invalid position) 
1-6 03 always sel 


420/180 cps SERIAL PRINTER: 


BITS MASK INTERPRETATION 

1 = 0%, @ = MOT OK (refer to the other bits below) 
49 0 = COVER OPEN; or RETRACT TAPE ERORER 

O = HEBIA ERROR 

400-0 = HEAD RETRACT FAILED 

QB always cet 

04 G = CARRIER ERROR Cjanned or outside Limits} 

G2 always set 

Gi 1 = set request 


See Ge Loe NT | 
mu 
cD 


LENE PRINTER! 


BLTS MASK INTERPRETATION 


7 8 0 = NOT OK 

& 4 @ = NOT READY 
S 20 @ = HO PAPER 

4 10 = ERROR 

3 8 @ = END OF PAGE 
2 always set 


PRINTER STATUS BYTES 
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TABLE 9.2.7 - PRINTER STATUS BYTES 


78 (60,120,180) CARRIER JAM 

7 (60) FORNS JAM 

oF (120,180) HEAD RETRACT ERROR 
oF (60,120, 180,LP) FORMS ERROR 
Ae (60,120,180,LP) ERROR 


TABLE 9.2.8 ~ KEYEDARD STATUS BYTE 


VALUE INTERPRETATION 


et ee ee a es nee et eet 


BUFFER OVERFLOW 
4 OBISCONNECTES 


ee ee en nme isp SS 
PRINTER STATUS BYTES (cont.) and 
KEYBOARD STATUS BYTE 
trees eect 


aiden tad tentear eters ete 
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TARLE 9.5% - S-FLAGS ~ DDR STATUS BYTE 


BITS MASK INTERPRETATION 


7 &2 Q = READ, 1 = WRITE 
4-4 70 CONTROLLER TYPE 
Ho OF © CURRENT DDR STATUS 


COMTROLLER TYPE (S-FLAGS AND @70@): 


VALUE INTERPRETATION 


9 KB, DI 

1 SP 

@ §§ 

3 tT 

é DH, DK, BF 
7 LP 


DOR STATUS (S-FLADS AND BOF@): 


VALUE TXTERPRETAT ION DISK USE 

Q normal arousal 

1 special arousal 

2 waiting on NCH 

3 first normal data request 

4 first special data request search i 

5 special request search 2 

4 request 1 search 3 

? request 2 data transafer 

g request g seeking 

? raguest 4 special (end of cylinder? seeking 
A request 9 

B request 4 read after write - readless read 
C request 7 last write on cylinder 

p request & fast transafer 

E final request 

F normal data request (handted by MIP) 


S-FLAGS - DDR STATUS BYTE 
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TABLE 9.3.4 - QHEAD HAP (3.01) ~ ID DESCRIPTOR QUEUE HEAD 


OFF LEN 
SET GTH FIELD USE FORMAT 
fueue Flags 
address of field TQDLK af first IQDESC (TABLE 9.3.3) 
address of final 19 descriptor on queue 
Drive Address (mutbidrive controllers 


LABEL 
TABLE f.d.2 - QUEUE FLAGS - FIELD OFL OF RAP BHEAD 


BITS MASK INVERPRETATION 


(0 ores 
> 20 1 = queue empty 
% 10 1 = queue not ready 
53 68 1 = e#adiness changed 
2 04 4 = return errors if not ready 
i 602) 1 = dequeue descriptors if not ready 
@ G1 1 = AYR help task must be run 


QHEAD MAP (3201): = IO DESCRIPTOR QUEUE HEAD and 


QUEUE FLAGS - FIELD QFL OF MAP QHEAD 
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JARLE 7.3.5 TQDESC RAP (3.01) ~ IU PLeerietiun 


OFF LEN 

SET GOTH FIELD USE FORMAT 
@ 2@  CONCHL Communicate Handler memory Link SR BR 
wow T0EL Descriptor Chain Link CIOBLE of next dascriptor) SR ER 
2 4 CONILKFLG Interlock Flab TABLE 9.7.4 
eo TODFL Bescriptor Flags a 

3 2  CONPHLK gonory address of associated PHT AA BR 
a " TOBLK “u a 

3S  @ CAH Buffer Start address in maaory SR BR 
W a Topas “ W 

7 CONSL Buffer Leagth GBR 

i " TODSL a u 

9 4 CDHFPH Print farateter - 

> 4 TORPH Paratioter (hoids task-id of requesting bask) TABLE 7.4.2 
19 1 CONLMADY nusher af finas 50 advance BINARY 
10 2 PaBDA Disk dddress(zero relative sector suaber B BR 
ii 2 CONCOLND column avaber B OBR 
i2 1 1ObBY Disk Unit - drive number : 

13 1 TOD.RISK.REYRIES count of retries on this operation BINARY 
13 6 = CONERUPN cursor~head-drive parameter bytes = 

144 8 108. CRE ICME CRE = 

i? i TODSPO bit settings for self scan spo 7 
wow CDHSPO . - 

“ - TGpep - LABEL 


IODESC MAP. (3.01) - I0 DESCRIPTOR 
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A CO a A TENA ES Min tO MO rt a rattan tesa nym cha 


TAELE 9.3.4 ~ 10 DESCRIPTOR INTERLUCK FLAGS 


BITS MASK INTERPRETATION 

ESCRIPTOR STATUS 

O = split buffer 10, 1 = normal buffer If 
4 TQ RESULT 

1 602 «64 = buffer not updated by systen 

, 


O 6 GL 01 = buffer empty 
DESCRIPTOR STATUS CIUDEL AND @Dou): 


VALUE INTERPRETATION 


CO nothing waiting for this 128 
i ft test mee b segs oe 
oo BAILIFF WaibihE Tor bits lu 
i 7 . 2 ryt tt 2 Wey PARP GD og Re 
46 TASK wathing for this 1D (eee TOPPA of Tarst TAGLE 3.2) 


+ 


MALUE INTERMRETATION 
ie Uk 

1G OLR (parity) erecr 

14 search failed (disk only} 

i0 eoek eprop (deck only 

ee tivalid request 

C8 sector act found (disk only) 

OF device switched off 

Qi mecia is write inhibit Curite oiiyd 


IO DESCRIPTOR INTERLOCK FLAGS 


ee A ern 


SECTION 10 


10. CMS DISK ORGANISATION 


The information on all disks used on CMS systems (excluding 
Industry Compatible Mini Disk - ICMD) is stored in files 
under the same logical structure. The layout and contents 
of a disk are sometimes relevant to dump analysis, and so 

a description of the CMS disk organisation is included in 
this document. 


The format of Key files, program files, and program dump 
files is described, as this is also relevant to the analysis 
of some memory dumps. 


The following utilities may be used to examine the information 
on a disk: 

a PD shows the contents of the disk directory namelist 

- KA analyses the disk directory and available table 


- LIST may be used to print any sector (e.g. LIST SYSMEM 
100 1) 


- DA prints and formats various items 


Refer to the CMS Software Operational Guide (form number 2007258) for 
operating instructions for these utilities. 


10.1 DISK AREAS 


Figure 10.1.1 shows the structure of the main elements of 

CMS disk organisation, which are: Track zero, a non-file 

directory: a file directory consisting of a namelist 

and a disk file header list: and the remainder of the disk 
which is divided into data areas. 


10.2 TRACK ZERO 


Track zero of CMS disks is used for two basic functions: 
a disk label which identifies the disk; and a bootstrap 
of machine code to enable the CMS system software to be 
started using this disk. 
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10. 


10.2 


10.3 


CMS DISK ORGANISATION (CONT.) 


TRACK ZERO (CONT.) 
10.2.1 DISK LABEL 


The disk label is located at sector zero of all 

CMS disks (see Table 10.2.1 for the format). The 
contents of many of the fields in this label, especially 
pointers to the directory items, must be valid if 

the integrity of the information stored on the disk 

is to be preserved. 


10.2.2 BOOTSTRAP 


The bootstrap area lies in sectors 2 to 25 on all 
CMS~initialised disks. However, the bootstrap is 
written in machine code, which varies with the hardware 
used. For example, the B80 bootstrap is different 
from the B800 bootstrap. Only disks initialised on a 
CMS B80 system are guaranteed to contain a valid B80 
bootstrap. Also, the bootstrap may change from release 
to release to accommodate new features. 


Since the bootstrap code performs the memory dump 
routine (PK4 or PK5), it is important that the correct 
bootstrap is present in this reserved area of the disk 
used to bootstrap the system (PK2) when a memory dump 
is to be taken. 


The bootstrap is written to sectors 2 to 25 by the IN 
and RF functions of the Stand-Alone Utility, which 
takes the information from the disk file called CMSBOOT. 


Disks used to take memory dumps from a system running 
a given level of MCP should be initialised using the 
same level of Stand-Alone Utility and CMSBOOT file. 


10.2.3 BAD AREA LOG 


This lies in sectors 30 and 31 of all CMS disks. 
It is not however, fully implemented on the B80 
3.01 system. Refer to section 10.3.1 for more 
information on bad areas. 


DISK DIRECTORY 


Although the three items of the disk directory are addressed 
independently by the disk label, the disk directory is 
usually a contiguous area on disk. Usually (though not 

on fixed disks initialised on the B80) this area follows 
directly after track zero (i.e. sector 32 onwards). 


10. CMS DISK ORGANISATION (CONT.) 


10.3 DISK DIRECTORY (CONT.) 
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10.3.1 


10.3.2 


10.3.3 


AVAILABLE TABLE 


The area is also known as the "non-file directory" 
because it addresses those parts of the disk which 
are not allocated to disk files. 


This section of the directory references all areas 

of the disk which are not assigned (see Table 10.3.1). 
When the disk initialise routine discovers a bad 

area of disk, an entry is made in the available table 
with length zero and start and end addresses reversed. 
purposes; this is achieved by considering the areas 

to be "bad". A "ghost entry" is also made in the 
available table which has a start address equal to zero 
and an end address equal to the last sector address 

on the disk +1, anda length of zero. 


FILE DIRECTORY ~ NAME LIST 
See EE 


This is a contiguous block of sectors containing 

the names of the files on the disk (see Table 

10.3.2). The MCP may reserve areas of disk by 
inserting a temporary entry with #82 in each byte 

of the name field. Unused entries have #81 in 

each byte of the name field. Each entry references 
an entry in the other part of the disk file directory, 
the DFH list, in the same relative position. 


DISK FILE HEADER (DFH) List 


Each sector in this area may contain a Disk File 

Header. The disk file header includes the detailed 
information about the file which it references. This 
information includes the type of file, the number of 
tasks using the file, and the location of the file areas. 
(See Table 10.3.3). 


Allocation and de-allocation of disk space consists 

of updating both the non-file directory and the file 
directory. If the system fails while this is in 
process, then areas of disk may not be assigned, or may 
become assigned twice. This symptom may be determined 
by executing the KA utility for the disk. 
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10.4 


CMS DISK ORGANISATION (CONT.) 


DISK DIRECTORY (CONT.) 


10.3.4 SYSMEM FILE 


The first file in the directory of all CMS disks is 
called SYSMEM. The DFH for this file references the 
entire disk from sector O to the end of the disk. This 
file may not however be accessed by user programs, and 
does not appear in the analysis performed by the system 
utilities such as PD. 


KEY AND TAG FILES 


CMS files with indexed organisation consist of two files on 
disk: the key or tag file, and the data file. The key file 
contains the record keys and relative record pointers to 

the data file. A tag file (or null key file) does not contain 
the record keys, and the indexed "file" may consequently 

only be accessed sequentially. 


Figure 10.4.1 shows the layout of a key/tag file and Tables 
10.4.1 and 10.4.2 describe the formats of the areas concerned. 


The first sector of a key file is the Key File Parameter Block 
(KFPB). This is followed by a rough table, an index region, and 
an overflow region. The length of each entry in the key file 

is determined by the length of the key as follows: 


key length not> 5 bytes : entry length = 8 bytes 
key length not>13 bytes : entry length = 16 bytes 
key length not >21 bytes : entry length = 24 bytes 
key length not >28 bytes : entry length = 32 bytes 


PROGRAM (S-CODE) FILES 


COBOL, RPG, MPLII and NDL program files all have the same 

basic structure (see figure 10.5.1). The file is one 
contiguous area on disk and has a Program Parameter Block 

(PPB) in the first sector (see table 10.5.1). The PPB contains 
reference information about the program and pointers to items 
within the code file. 


The Program Segment Table (PST) (see Table 10.5.2) contains 
descriptors pointing to the S-code segments of the program. 
The data Segment Table (DST) (see table 10.5.2) contains 
descriptors referencing the data segments of the program. 
The CCB Preset Area (CCBPA) contains the COP Table for COBOL 
and RPG programs. The Internal File Name Block (IFNB) con- 
tains a list of file names of the files used by the program. 


When a program is executed, these elements of the code file 
are used to build the Task Structure discussed in section 8. 


10. CMS DISK ORGANISATION (CONT.) 


10.6 
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PROGRAM DUMP FILES 


A program dump file consists of three parts (see figure 
10.6.1) which reside in two areas of disk. These three 
parts are the PPB, all the data segments (excluding FIBs), 
and the TCB. All of these items are obtained from the run 
structure of the task. 


The PPB is obtained from the program code file with bytes 
178-179 updated to contain the logical record number of the 
start of the TCB in the file. The data segments (excluding 
locked segments) are copied from the tasks's virtual memory 
file, all segments being updated from the memory copy, if 
the segment is present in memory as well as in the Virtual 
Memory file. Each segment starts on a sector boundary. The 
TCB is a copy of the ITCB trom memory, including all locked 
segments. 


LOW bh CMS DISK ORGANISATION 


BOOTSTRAP 


AVAILABLE 
TABLE 


NAMELIST 


FILE AREAS 


CMS DISK ORGANISATION 


10.4.1 KEY FILE ORGANISATION 


KFPB 


ROUGH TABLE 


INDEX REGION 


OVERFLOW REGION 


KEY FILE ORGANISATION 
a ee ee, 
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10.5.1 PROGRAM FILE ORGANISATION 


PCB 


PROGRAM 
SEGMENTS 


S—CODE 
SEGMENTS 


PROGRAM FILE ORGANISATION 


10.6.1 PROGRAM DUMP FILE STRUCTURE 


DATA SEGMENTS 


DISK AREA 
#1 


SLICE 
DESCRIPTOR 


DISK AREA 
#2 


PROGRAM DUMP FILE STRUCTURE 
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TABLE 10.2.1 - DISK LABEL 


fo Seoeo a a a a a 
BYTE CONTENTS 
o-3 evoli” 04 EcecoIc) 
4-9 Serial no. 06 E 
10 Blank (Access coce) 01 E 
11°20 “"SLOINTERAL” 10 E 
21727 Cartridge identifier G7 ACSCIT) 
28-29 "som (System [Interchange code) 02 E 
30 Zero (Pack Code) 01 E 
31736 Reserved scratch 06 = 
37°50 Owner's Identification 24 A 
51-78 Reserved Scratch 28 = 
79 Blank OL E 
@0783 “VOL2" 04 E 
84-88 Initialisation Date CYYCO0) 05 E 
CO=94 Initialising System Ceg.*"BDS™) 06 E 
95 "Re if restricted cartricce Ol A 
96°97 Noe of Cylinders v2 BCINARY) 
98 Noe of Tracks-Cylinder o1 B 
99 No. of Sectors~-Track 01 B 
1035 No. of Sectors for Directory 01 8 
Name List 
101-102 Sector Adcress of Directory 03 B 
Name List 
104 Noe of Sectors for Available Table, C1 B 


re eres ct cr LR SL CON 
DISK LABEL 
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TABLE 11 - DISK LABEL cont. 
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BYTE 


105-107 
108-109 
110 


111i"113 


114-118 
119 

120125 
126-131 
132°135 


136-179 


CONTENTS 


Sector Adcress of Available Table 
Maximum no. of files 
Unit of Altocation(sectors) 


Sector Address of First Fite 
Header 


Reserved protected 


Integrity Flag (0 = OK) 


Actual Error Count 
Bad Sector Count 
Reserved for MTR 


Reserved Scratch 


DISK LABEL cont. 


DATA CODE 


B 
8 
8 
B 
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TABLE 10.2.2 - BAD AREA LOG 


CONTENTS 


O-1 Total cf bad allocation units recorded in this log 


2°31 Binary zero. Reserved for possible future expansion 


32° 33 Address of first cf grcup cf contiguous bad allocation units 


34-35 Nurber of allocation units in sroup 


367359 8i more address/length pairs 


camer yn et sR PAC AE CS LL LES CE CS 


BAD AREA LOG 
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TABLE 10.3.1 - AVAILABLE TABLE BLOCK 


CONTENTS 


Length of available area in BCINARY) 
allocation units ** 


Address of first available 
allocation unit ** 


Address of last avaitable 
atlocation unit +i 


6°173 28 more 6 byte entries 


174-179) Sterite area Calways zeroes) 


ae An unused antry has 
allocation unit adcress 


AVAILABLE TABLE BLOCK 
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TABLE 10.3.2 - NAME LIST BLOCK 


BYTE 
O-11 
12 

13 
14°15 
16°175 


1767179 


10-14 


CONTENTS 
File Identifier 
Reserved (Stank character) 
Directory Index 
Header Sector Address 
Ten more 16 byte entries 


Zero 


Notes 


Available directory entries. 
present correspond to files but could do so in the future 
contain #@C in each of the first 
Bytes 14-15 of such entry contain the disk 


SIZE 


12 tytes of the 


sector hotding this directory entry. 


DATA CODE 
ACSCIT) 
A 


BCINARY) 


entries which cdo not 


A directory entry whose corresponding file header is 


of a4 temporary file» j-e- 
contains #81 in each of the first 12 bytes of the 
and the sector address of the header 


Since each block of the 


eleven entries and the total no. 
multiple of eleven» it ts possibie that the Last 
of the name List contains unusable entries. 
are marked by #82 in each of the first 12 
entry and Zero in bytes 14-15. 


The directory index gives the 
entry within the directory. 


2564 


NAME LIST BLOCK 


has not been closed with 


name 


ordinal 
The number 


in bytes 14715. 


tist can 
of headers may not be 


position of 
is recorced moculo 


entrye 
address cf 


lock» 
entry 


sector 
Such ertries 
bytes of 


TABLE 10.3.3 - DISK FILE HEADER (DFH) 


BYTE CONTENTS 


0-11 File Identifier 


12 Blank 


13 File Type(see table 6.4.4.2) 


14717 Flags 


18-22 Creation Date CYYDODD) 


23727 Last Access Date (YYDDD) 


28°29 Record size Cin bytes) 


30-31 No+ of records per block 

32-33 NO. Of Sectors per block 

34 Tmplementation Level No. 

35°37 Maximum file size (records) 

38-40 Save factor (07999) 

41 Maximum area in use (0 = None) 
42-43 No. of records in tast area 

44°45 Generation No. 

46-47 No- of spare charse in last record 


(Stream I[-0) 


Pack-id of overftow pack 


User count 


Area Bit Map 1 


Area Bit Map 2 


Address of ist File Areg 


Size of ist File Area 


DISK FILE HEADER (DFH) 
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TABLE 10.3.3 - DISK FILE HEADER cont. 


BYTE CONTENTS SIZE NOTES 


64-123 15 mote address-size pairs 60 B 


1247128 Reserved for implementation 
dependant overflow pack pointers 


8 


129-131 No. of records in file 03 8 


NOTES 


mseowe 


ASCII characters 
Binary number 


Flags. 


Bit 0 set = file has been “crunched” 


Bit 1 set rough table valid 


Bit 2 set 


file has section on overflow péck 


Bit 3 set = single area file 


are currently, unassigned 
Ts Fite identifier 


The contents of the file~id field are atways the same as 
the contents of the filetid in the corresnondine entry in 
the directory name list Ceven to being filled with #80 or 
#Bifor available entry and temporary entry 
respectively). 


ui: User counts 
total number of users (7=tccked) 


spere 
number of output users. 


number of lock access users 


DISK FILE HEADER cont. 
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TABLE 10.3.3 - DISK FILE HEADER cont. 


M 5 Afea bit maps. 


Area bit maps are 16 bit fields in which eact bit 
represents one of the 16 possible file areas- The most 
Ssignificent bit in the bit map corresponcs to the first 
file area and the least significant bit to the 16th grea. 


The bits in area bit map have the following 
Significancez- 


Set area allocated and on this pack. 


Reset = are not allocated 
or on other Coverflow) pack. 


The bits in area bit map 2 have the followina 
Significance. 


set = area allocated and on other pack. 
reset = area not ailocated or on this pack. 


S t- 


Addresses anc sizes of file areas are in terms of the 
allocation unit of this pack which is an integer multiple 
of sectors and fixea at initialisation time. 


Addresses for areas on an overflow pack are not 
necessarily correct. Sizes for areas on an overflow pack 


are correct and are given in terms of the sltocation unit 
of this pack. 


DISK FILE HEADER cont, 
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TABLE 10.3.4 - DFH FILETYPES 


TYPE CODE 
Normal data ("0") #00 
Source language #01 7 #O0E 
Source Library £OF 
Ordinary program (S~-code) #10 - #13 
Interpreter for BDS #14 > #17 
Interpreter for B700 #18 - #18 
Interpreter for Bi70C #iC 7 #1F 
Sysmenm #20 

VM file #20 
Indexed ("I") #80 #2 
Key fite ("7K") #81 


*#*x Value #80 never appears in file header tut is used in 
7PB to indicate that an incexed file is being opened. 


FILETYPES 
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TABLE 10.4.1 - KEY FILE PARAMETER BLOCK (KFPB) 


Implementation Level No. 
Spare 

Pack-id of data file 
File-id of data file 
Blank 


Space for implementation cefined 
link to data file 


KFPB flaqs - true if bit set 

Bit : B€Q created rough table 
Bit B700 created rough table 
Bit 81709 created raugh table 
Bit 
Bit 


oe 0s 46 oe 


Duplicates allowed 


Relative record nos at start 
of rough table 


Length of rough table in sectors 


Spare 


Relative record no- of start of 
overflow regicn 


Size of overflow region in sectors 


41-43 Relative record no. of start of 
index region 


44-46. Size of index region in sectors 


ee een ET SE SS ST SY ASTON. 


KEY FILE PARAMETER BLOCK (KFPB) 


2015400 


Deta file is a dual pack fite 


ed 
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TABLE 10.4.1 - KEY FILE PARAMETER BLOCK cont. 


CONTENTS 


47 


&4B°49 Size of key part in bytes 


50-51 


Offset of keypart from base of 
data record in bytes 


s2°55 
567179 
ASCII characters 
Binary number 


Cc : SeteReset by close 


KEY FILE PARAMETER BLOCK cont. 
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TABLE 10.4.2 


BYTE 0 
CENTRYSZ 


CENTRYS2Z 
CENTRYSZ 


2015400 


ROUGH TABLE ENTRY 


Highest key value in this group of index 
sectorseleft justifiedsbirary zero filled. 


Lowest sector address in this group of 
sectors. 


1) The format of rough table is implementation Cependent. 
ALl implementations ares however» required to assign 
sufficient disk space to accomodate a rouch table> 
formatted aS above» with a group size of 32 sectcrs. 


2) The rough table is not updated if the record 
corresponding to the highest key in a group of sectors is 


deleted. 


ROUGH TABLE ENTRY 
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TABLE 10.4.3 


“KEY ENTRY (INDEX OR OVERFLOW) 


BYTE 9 


Key value-rleft 
CENTRYSZ 


justified»binary zero fittlec. 


CENTRYS2Z 


Relative record no- within data file of 
CENTRYSZ keyed record. 


oe of a record is indicated by zeroing the 
jela. 


KEY ENTRY (INDEX OR OVERFLOW) 
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TABLE 10.5.1 - PROGRAM PARAMETER BLOCK (PPB) 


PURPOSE OF FIELD 
Implementation levet 
NO,» 


Program nate. 


S*tanguage name. 
Interpreter pack7ic. 
Interpreter name- 
Compiter name. 
Compilation date. 
Priority class- 


Data segment for 
initiating message. 


S*program start address. 


Program segment 
table length. 


P.SeTe location. 


Data segment table 


C-S-T~ location. 


TCB preset area 


flonoth. 
sengtn 


TCB preset area 
address. 


(Partial)Stack lLenath. 


CCB preset area 
length. 
CCB preset area 
address. 


SIZE REF 


1 8 
12 

12 

7 


12 


2 B 
1 8 
3 B 
2 B 
2 8 
2 8 
2 B 
2 8 


COMMENTS 


Standare 12 character 
file ads in FP8. 
For documentation. 


For documentation. 


YYMMDD. 


See Table 4-2.1.2. 


aFF implies 
discard message. 


Segment\Displacement. 
NO- of segments *6 
Logical record no. 
within this fite. 

NO. of secgrents *6. 


Logicat record no. 
within this file. 


In bytes. 

Byte disSolacement 
Within PPB. 

In bytes. 


In bytes. 


Logical record no. 
Within this file. 


2015400 


PROGRAM PARAMETER BLOCK 


(PPB) 
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TABLE 10.5.1 - PROGRAM PARAMETER BLOCK (PPB) 


&6°87 TCB preset 
extension Length. 


88-89 Internal file name 
block length. 


9O°91 Internal file name 
block address. 


“c= TCB preset area values. 


PROGRAM PARAMETER BLOCK (PPB) 
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B In bytes. 
B In bytes. 
B Logical record within 


this file. 


--~ Variable length. 


cont. 


TABLE 10.5.2 - PROGRAM SEGMENT DESCRIPTOR 


2015400 


TYPE CQOE 


value = 0 : ordinary code or data segment 
(bytes 253 = 0 implies 2 zero 
filled work area) 


> this read"write data segment 
is an FIB 


3 a dummy ertry wilt be built in the 


segment table (bytes 2535455 = 0) 


2 uninitialised Cgarbage filled) work 


segment (bytes 2°3 = 0) 


Byte 1 FLAGS 

bit Osl»2e35455 used by OS 
bit 6 set lock in main store 
bit 7 set = read-write segment 


(never set for code» must be set 
if bytes 2,3 = 0) 


Bytes 22 Relative record number within 
file at start of segment 


Bytes 495 Length of segment in bytes +¢ 


+ For an FIB segment descriptors byte 5 contains 
Segment number of the appropriate FPB segment. 


PROGRAM SEGMENT DESCRIPTOR 


the 
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TABLE 10.5.3 - PROGRAM INTERNAL FILE NAME BLOCK ENTRY 


Byte 0 OST index of FI 


Byte l OST Index of FPB 


Bytes 2729 Internal fite name. 


Left justified and 
blank filled 


PROGRAM INTERNAL FILE NAME BLOCK’ ENTRY 
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APPENDIX A 


APPENDIX A - INDEX OF TERMS 


AVAILABLE TABLE 


Non disk Directory 


AVR - Automatic Volume Recognition 
BAILIFF - MCP Task O 

CCB - Code Control Block 

CPA - Communicate Parameter Area 


CT, C.TABLE 


Configuration Table 


DDR - Device Dependent Routine 
DFH - Disk File Header 

DIAGCBUF - Global Diagnostics Buffer 
DST - Data Segment Table 

EPAR - Execution Parameter Area 
EScT - Execution Scan Table 

EVICT ~ Bailiff operation 

FDR - Function Dependent Routine 
FIB - File Information Block 

FPB - Pile Parameter Block 

GLBLM - Global MCP (Bailiff) Map 
GLOBAL - MCP tables 

GWA - Global Work Area 

ICB - Interpreter Control Block 
IFIB - Indexed File Information Block 
IFNB - Internal File Name Block 
INTERGLBL - Interpreter Global Work Area 
IODESC - Input-Output Descriptor 
KFPB - Key File Parmeter Block 
LOADER - MCP task 15 

LOCKS - MCP task control 

MCH - Master Communicate Handler 
MIP - Master Interrupt Processor 
NAMELIST - Disk Directory 

2015400 


Section 


10.3.2 


APPENDIX A 


OPENCLOSE 
OVERLAY 
OVERLAYABLE 


PCB 

PHDMP 

PHT 

PINK LINK 
PPB 


RESTORE 
ROUGH TABLE 
RS 


SAT 

SCL 

SD 
S-FLAGS 
S1WA 
SLICE 
SWAP 


TASK 

TASK. TABLE 
TCB 
THRASHING 


VERSION. INFO 
VM 
VMWA 


WAKT 


INDEX OF TERMS (CONT.) 


MCP slice 17 
Virtual Memory Operation 
Area of Memory 


Program Control Block 


Peripheral Handling Dump Area 


Peripheral Handling Table 
Slice Memory Structure 
Program Parameter Block 


Bailiff Operation 
Key File Area 
Slice Descriptor 


Slice Address Table 
System Control Language 
Segment Descriptor 

DDR status 

S-Interpreter Work Area 
Area of Memory 

Virtual Memory Operation 


Independent Runner 
Logical Task Information 
Task Control Block 
System State 


Global MCP Table 
Virtual Memory 


Virtual Memory Work Area 


Wait Key Table 


Section 


